CLI

The amodal CLI is the primary interface for building, running, and deploying agents. Install it globally or use via npx:

npm install -g @amodal/cli
# or
npx amodal <command>

Commands

Command	Description
`init`	Scaffold a new agent project
`dev`	Start local dev server with hot reload
`validate`	Check config for errors
`inspect`	Show compiled context with token counts
`build-manifest-types`	Generate TypeScript types from manifest

Command	Description
`connect`	Add a connection (plugin or custom)
`sync`	Sync API specs from remote sources
`install`	Install marketplace packages
`uninstall`	Remove packages
`list`	List installed items
`update`	Update packages
`diff`	Show package changes
`search`	Search the marketplace
`publish`	Publish to the registry

Command	Description
`chat`	Interactive terminal chat with your agent
`serve`	Run from a snapshot file
`test-query`	Fire a one-off query against the agent

Command	Description
`deploy`	Deploy to the platform
`login`	Authenticate with the platform
`link`	Link local project to platform
`status`	Show deployment status
`rollback`	Revert to a previous deployment
`deployments`	List deployments
`promote`	Promote a snapshot to production
`secrets`	Manage encrypted secrets
`docker`	Build a Docker image
`audit`	View audit logs
`automations`	Manage automation schedules

Command	Description
`eval`	Run evaluation suites
`experiment`	Compare models, prompts, or configs
`test-query`	Test a single query

The CLI resolves credentials in order: