​

cast invoke

​

Usage

cast invoke <slug> [prompt] [options]

​

Arguments

​

Options

​

Examples

​

Basic invocation

cast invoke my-agent "What files are in the current directory?"

The current directory contains:
- src/index.ts
- package.json
- castari.json
- CLAUDE.md
- README.md

​

Read prompt from a file

cast invoke my-agent -i prompt.txt

​

Multi-turn conversations

# Start a session
cast invoke my-agent "Create a file called hello.txt" -s my-session

# Continue the same session (sandbox state preserved)
cast invoke my-agent "What's in the file you just created?" -s my-session

​

What Happens During Invoke

1. Request received — Your prompt is sent to the Castari API
2. Sandbox activated — A sandbox is spun up (or reused if session specified)
3. Agent runs — Your agent code executes with the prompt as input
4. Response collected — Output is captured and returned to you
5. Cleanup — Without a session, sandbox is destroyed. With a session, it persists.

​

Errors

​

See Also

• cast deploy — Deploy an agent
• SDK invoke — Invoke programmatically