Developer CLI
Studio is the primary interface for creating, deploying, and operating agents. The amodal CLI is optional developer tooling for local iteration, scripted checks, and advanced workflows.
Install it globally or use via npx:
npm install -g @amodalai/amodal
# or
npx amodal <command>Commands
Project and Local Development
| Command | Description |
|---|---|
init | Scaffold local agent files |
dev | Start a local development server |
validate | Check config and test live connections (--skip-test to disable) |
inspect | Show compiled context with token counts |
build-manifest-types | Generate TypeScript types from manifest |
Packages (amodal pkg)
| Command | Description |
|---|---|
pkg connect | Add a connection (plugin or custom) |
pkg sync | Sync API specs from remote sources |
pkg install | Install marketplace packages |
pkg uninstall | Remove packages |
pkg list | List installed items |
pkg update | Update packages |
pkg diff | Show package changes |
pkg search | Search the marketplace |
pkg publish | Publish to the registry |
pkg link | Link a local package for development |
Deploy (amodal deploy)
| Command | Description |
|---|---|
deploy push | Deploy to the platform when using CLI-based workflows |
deploy build | Build a deployment snapshot |
deploy serve | Run from a snapshot file |
deploy status | Show deployment status |
deploy list | List deployments |
deploy rollback | Roll back to a previous deployment |
deploy promote | Promote a deployment |
Runtime Testing
| Command | Description |
|---|---|
chat | Interactive terminal chat for local or remote testing |
test-query | Fire a one-off query against the agent |
Testing & Evaluation
| Command | Description |
|---|---|
eval | Run evaluation suites |
test-query | Test a single query |
Ops (amodal ops)
| Command | Description |
|---|---|
ops secrets | Manage secrets in CLI-based workflows |
ops docker | Docker image management |
ops automations | Manage automations |
ops audit | View audit logs |
ops experiment | Compare models, prompts, or configs |
Auth (amodal auth)
| Command | Description |
|---|---|
auth login | Log in to the platform |
auth logout | Log out |