Reference
CLI commands
Every command takes the global scope flags first, then a command group and its options.
codel00p [global flags] <command> [options]Global flags
Required on every command, before the command group.
| Flag | Meaning |
|---|---|
--memory-db <path> | SQLite database for memory and sessions |
--organization-id <id> | Organization scope |
--project-id <id> | Project scope |
--project-name <name> | Project display name |
Commands
| Command | Purpose |
|---|---|
agent run | Run one agent turn |
agent resume | Resume a persisted session |
agent mcp | List or diagnose attached MCP servers |
memory | Review, search, edit, and audit memory |
session | Inspect persisted sessions |
mcp serve | Run codel00p as an MCP server |
mcp permissions | Inspect remembered connector decisions |
agent run options
| Option | Meaning |
|---|---|
--provider <id> | Provider id or alias |
--model <id> | Provider model id |
--workspace <path> | Workspace root (defaults to cwd) |
--tool-set <name> | read, edit, command, git, or all |
--permission-mode <mode> | allow, ask, or deny |
--session-id <id> | Persist under a stable session id |
--max-iterations <n> | Cap model and tool iterations |
--mcp-server <id=cmd> | Attach an MCP stdio server |
--base-url <url> | Override the provider base URL |
--provider-policy-preset <id> | Apply a built-in policy preset |
--stream-events | Stream harness events during the turn |
--json-events | Print serialized events after the answer |
Note
Append --help to any command or subcommand to see its full, current option list straight from the binary.