AgentScale
@jpbonch
npx machina-cli add skill @jpbonch/agentscale --openclawFree Tier
- No signup or payment required to start.
- Run
npx agentscale registerto get an API key. - Free deploys expire after 1 hour.
- Limited to 1 service.
Paid Tier
- Add credits to remove the 1-hour expiry and deploy permanently.
- Use
npx agentscale accountto check your tier and credit balance. - When you need to add credits, use the
agentspend paycommand or the AgentSpend skill.
Commands
Register
npx agentscale register
Generates an API key and saves it to ~/.agentscale/config.json.
Deploy
npx agentscale deploy
Run this from your project directory. Packages the current directory and deploys it.
Options:
--name <name>— Service name (auto-generated if omitted)
List
npx agentscale list
Lists your services and their status.
Account
npx agentscale account
Shows your account tier (free/paid) and credit balance.
To add credits, use the agentspend pay command:
agentspend pay https://api.agentscale.co/add-credits \
--header "x-api-key:<your-api-key>" \
--body '{"amount_cents": 500}'
Or pay directly with an x402 wallet by calling POST /add-credits with your x-api-key header and amount_cents in the body.
Project Requirements
- Deploy APIs and web services. Supports Node.js, Python, Go, and more.
- Your project needs a standard structure to be auto-detected:
- Node.js: a
package.jsonwith a start script. - Python: a
requirements.txt. - Go: a
go.mod.
- Node.js: a
- Custom domains, build commands, and start commands are not yet supported.
Environment Variables
AGENTSCALE_API_URL— Overrides the default API base URL. Warning: this redirects all API calls, including those carrying your API key, to the specified URL.
System Requirements
tarmust be available on PATH (used to package projects for deploy).
Limits
- Upload: 100 MB compressed, 500 MB decompressed.
Overview
AgentScale packages your project and deploys it to a public URL with a single command. It supports Node.js, Python, Go, and other standard project structures. The Free Tier offers short-lived deployments (1 hour) with a limit of one service, while the Paid Tier adds credits for permanent deployments.
How This Skill Works
From your project directory, AgentScale packages the current folder using tar and deploys it to a public URL via the deploy command. It auto-detects standard structures (Node.js with package.json, Python with requirements.txt, Go with go.mod) and uses your API key stored at ~/.agentscale/config.json. Custom domains and additional build or start commands are not yet supported.
When to Use It
- Quickly publish a Node.js, Python, or Go app to a public URL for a demo
- Demo an API or web service to stakeholders with a time-bounded URL
- Test deployment without setting up CI/CD or servers
- Share a public link for client feedback before committing to a paid plan
- Upgrade to permanent deployment by adding credits when ready
Quick Start
- Step 1: Run npx agentscale register to generate and save your API key
- Step 2: From your project root, run npx agentscale deploy --name <service-name> to package and deploy
- Step 3: Run npx agentscale list to verify deployment and obtain the public URL
Best Practices
- Ensure your project has a standard structure: Node.js (package.json with start script), Python (requirements.txt), or Go (go.mod)
- Keep tar on PATH since packaging uses tar during deploy
- Run npx agentscale register to obtain an API key and store it at ~/.agentscale/config.json
- Use --name to set a readable service name (auto-generated if omitted)
- Be mindful of Free Tier limits: 1-hour expiry and a maximum of 1 service; upgrade if permanent deployment is needed
Example Use Cases
- Deploy a Node.js REST API from a local folder and share a public URL for a quick demo
- Publish a Python Flask app for client review with a temporary public URL
- Publish a Go web service and verify accessibility via the public URL
- Demonstrate a web app to stakeholders and decide whether to upgrade
- Upgrade to permanent deployment by adding credits via agentspend pay
