Deploy to Castari

Deploy a Claude AI agent to production on Castari. This skill walks through the full flow: CLI installation, authentication, project scaffolding, and deployment.

Workflow

Follow these steps in order. Skip any step whose prerequisite is already satisfied.

Step 1: Check if the Castari CLI is installed

Run:

cast --version

If the command fails or is not found, install the CLI:

npm install -g @castari/cli

Then verify installation succeeded by running cast --version again.

Step 2: Check authentication

Run:

cast whoami

If the user is not logged in (command fails or shows "not authenticated"), run:

cast login

This opens a browser for Clerk OAuth. Wait for the user to complete login, then verify with cast whoami again.

Step 3: Check for castari.json

Look for castari.json in the current working directory:

ls castari.json

If castari.json exists: Read it and confirm the configuration with the user. Proceed to Step 4.

If castari.json does not exist: Help scaffold one:

1. •

   Detect the likely entrypoint by checking for these files in order:

   • •src/index.ts
   • •src/main.ts
   • •index.ts
   • •src/index.js
   • •src/main.js
   • •index.js
2. •

   Ask the user for the agent name using AskUserQuestion. Suggest the current directory name as the default.

3. •

   Generate castari.json with this structure:

{
  "name": "<agent-name>",
  "version": "0.1.0",
  "entrypoint": "<detected-entrypoint>",
  "runtime": "node"
}

Write the file and show the user what was created.

Step 4: Deploy

Run the deployment:

cast deploy

This packages the project, uploads it, and deploys to an isolated cloud sandbox. The command may take up to a minute. Show the user the output including status and sandbox ID.

Step 5: Verify deployment

After successful deployment, show the user a summary:

• •Agent name/slug
• •Deployment status
• •Sandbox ID (if returned)

Step 6: Offer to test

Ask the user if they want to test the deployed agent. If yes, ask for a test prompt and run:

cast invoke <agent-slug> "<test-prompt>"

Error Handling

• •npm not found: Ask the user to install Node.js (>= 18) first.
• •Authentication failure: Suggest running cast login again or checking network connectivity.
• •No entrypoint detected: Ask the user to specify their entrypoint file manually.
• •Deploy failure: Show the full error output and suggest checking castari.json configuration or running cast agents list to verify the agent exists.

Notes

• •The CLI requires Node.js >= 18.
• •Authentication uses Clerk OAuth (browser-based).
• •Deployments run in isolated cloud sandboxes.
• •The castari.json file is the project manifest — it must be in the repo root.
• •Common entrypoints: src/index.ts for TypeScript projects, index.js for JavaScript.