cast deploy

Deploy an agent to Castari.

Usage

cast deploy [slug]

Arguments

Argument	Description	Required
`slug`	Agent slug	No (read from `castari.json` if in project directory)

Examples

Deploy from a Castari project directory

If you’re inside a directory with a castari.json file, just run:

cast deploy

The CLI reads the slug field from castari.json. If no slug field is present, it derives the slug from the name field.

Deploy a specific agent

cast deploy my-agent

Deploys the agent with slug my-agent, pulling code from its configured git repository.

What Happens During Deploy

Fetch Code

Code is pulled from the agent’s configured git repository.

Create Sandbox

An isolated E2B sandbox is created for your agent.

Install Dependencies

npm install runs inside the sandbox.

Inject Secrets

Any secrets you’ve set become environment variables.

Ready

Agent status becomes active. Ready to invoke.

Agent Configuration

Your agent needs a castari.json file:

{
  "name": "my-agent",
  "slug": "my-agent",
  "version": "0.1.0",
  "entrypoint": "src/index.ts",
  "runtime": "node"
}

Redeploying

Running cast deploy on an already-deployed agent will redeploy it:

Previous sandbox is destroyed
New sandbox is created
Latest code is deployed

Redeploying does not preserve sandbox state. All files and data in the sandbox are lost.

Errors

Error	Cause	Fix
`Agent not found`	Invalid slug	Check `cast agents list` for correct slug
`castari.json not found`	Not in a project directory	Specify the slug explicitly or `cd` to your project
`npm install failed`	Dependency error	Check `package.json`, run `npm install` locally first
`Authentication required`	Not logged in	Run `cast login`

Getting Started

CLI Reference

SDK Reference

Concepts

Guides

cast deploy

cast deploy

Usage

Arguments

Examples

Deploy from a Castari project directory

Deploy a specific agent

What Happens During Deploy

Agent Configuration

Redeploying

Errors

See Also

​cast deploy

​Usage

​Arguments

​Examples

​Deploy from a Castari project directory

​Deploy a specific agent

​What Happens During Deploy

​Agent Configuration

​Redeploying

​Errors

​See Also

cast deploy

Usage

Arguments

Examples

Deploy from a Castari project directory

Deploy a specific agent

What Happens During Deploy

Agent Configuration

Redeploying

Errors

See Also