CLI reference
Complete reference for the Agent Apps CLI commands and global options.
CLI reference
Global options
| Option | Description |
|---|---|
--config <path> | Path to explicit agentapps.json |
--cwd <dir> | Working directory |
--json | Output raw JSON |
--yaml | Output raw YAML |
--raw | Raw tool result |
--manual-code | Force manual OAuth code entry |
--yes, -y | Skip confirmation prompts |
--verbose, -v | Show extra detail |
--help, -h | Show help |
Local state
Stored in .agentapps/ inside your workspace. Add to .gitignore.
| File | Purpose |
|---|---|
.agentapps/instances.json | Installed instances |
.agentapps/user-secrets/<alias>.json | User secrets per instance |
.agentapps/history | REPL command history |
Workspace configuration
The CLI reads agentapps.json from the current working directory, searching upward through parent directories.
{
"apps": [
{ "source": "./apps/hello" },
{ "source": "./apps/gmail" }
]
}