agents|cleveragents [--data-dir <DATA_PATH>] [--config-path <CONFIG_PATH>]
[--format (rich|color|table|plain|json|yaml)]
[--help|-h] [--version]
[--install-completion [<INST_SHELL>]] [--show-completion [<SHOW_SHELL>]]
[-v...] <COMMAND> [<ARGS>...]
agents version
agents info
agents diagnostics
agents init [--yes|-y]
agents session create [--actor <ACTOR>]
agents session list
agents session show <SESSION_ID>
agents session delete [--yes|-y] <SESSION_ID>
agents session export [(--output|-o) <FILE>] <SESSION_ID>
agents session import (--input|-i) <FILE>
agents session tell --session <SESSION_ID> [--actor <ACTOR>] [--stream] <PROMPT>
agents project create [(--description|-d) <DESC>] [--resource <RESOURCE>]...
[--invariant <INVARIANT>]... [--invariant-actor <ACTOR>] <NAME>
agents project link-resource [--read-only] <PROJECT> <RESOURCE>
agents project unlink-resource [--yes|-y] <PROJECT> <RESOURCE_NAME>
agents project list [(--namespace|-n) NS] [<REGEX>]
agents project show <PROJECT>
agents project delete [--force|-f] [--yes|-y] <NAME>
agents project context set[--view (strategize|execute|apply|default)]
[--include-resource <INCLUDE_RESOURCE>]...
[--exclude-resource <EXCLUDE_RESOURCE>]...
[--include-path <INCLUDE_GLOB>]...
[--exclude-path <EXCLUDE_GLOB>]...
[--hot-max-tokens <N>]
[--warm-max-decisions <N_WARM_MAX>]
[--cold-max-decisions <N_COLD_MAX>]
[--query-limit <N>]
[--max-file-size <MAX_FILE_BYTES>]
[--max-total-size <MAX_TOTAL_BYTES>]
[--summarize|--no-summarize]
[--summary-max-tokens <N>]
[--strategy <STRATEGY>]...
[--default-breadth <N>]
[--default-depth <INT_OR_NAME>]
[--depth-gradient <HOP:INT_OR_NAME>]...
[--skeleton-ratio <FLOAT>]
[--temporal-scope (current|recent|all)]
[--auto-refresh|--no-auto-refresh]
[--execution-environment <RESOURCE_NAME>]
[--execution-env-priority (fallback|override)]
[--clear] <PROJECT>
agents project context show [--view (strategize|execute|apply|default)]
<PROJECT>
agents project context inspect [--view (strategize|execute|apply|default)]
[--strategy <STRATEGY>]
[--focus <UKO_URI>]...
[--breadth <N>] [--depth <INT_OR_NAME>]
<PROJECT>
agents project context simulate [--view (strategize|execute|apply|default)]
[--budget <TOKENS>]
[--focus <UKO_URI>]...
[--strategy <STRATEGY>]...
<PROJECT>
agents validation add --config|-c <FILE> [--update]
agents validation attach [--project <PROJECT>|--plan <PLAN_ID>]
<RESOURCE> <VALIDATION> [<ARGS>...]
agents validation detach [--yes|-y] <ATTACHMENT_ID>
agents actor run [(--output|-o) <OUTPUT_FILE>]
[-v...] [--unsafe|-u] [--context <CONTEXT_NAME>]
[--context-dir <CONTEXT_PATH>] [--load-context <LOAD_CONTEXT_NAME>]
[(--temperature|-t) <TEMP>] [--allow-rxpy-in-run-mode]
[--skill <SKILL>]... <NAME> <PROMPT>
agents actor add --config|-c <FILE> [--update]
agents actor remove <NAME>
agents actor list
agents actor show <NAME>
agents actor context remove [--yes|-y] (--all|-a|<NAME>)
agents actor context list [<REGEX>]
agents actor context show <NAME>
agents actor context export (--output|-o) <FILE> <NAME>
agents actor context import [--update] (--input|-i) <FILE> [<NAME>]
agents actor context clear [--yes|-y] (--all|-a|<NAME>)
agents skill add --config|-c <FILE> [--update]
agents skill remove [--yes|-y] <NAME>
agents skill list [(--namespace|-n) <NS>] [--source <SOURCE>]
agents skill show <NAME>
agents skill tools <NAME>
agents tool add --config|-c <FILE> [--update]
agents tool remove [--yes|-y] <NAME>
agents tool list [(--namespace|-n) <NS>] [--source <SOURCE>] [--type (tool|validation)] [<REGEX>]
agents tool show <NAME>
agents lsp add --config|-c <FILE> [--update]
agents lsp remove [--yes|-y] <NAME>
agents lsp list [(--namespace|-n) <NS>] [--language <LANG>]
agents lsp show <NAME>
agents lsp serve [--log-level <LEVEL>]
agents resource type add --config|-c <FILE> [--update]
agents resource type remove [--yes|-y] <NAME>
agents resource type list [<REGEX>]
agents resource type show <NAME>
agents resource add [(--description|-d) <DESC>] [--update] <TYPE> <NAME> [type-specific-flags...]
agents resource remove [--yes|-y] <NAME>
agents resource list [--all] [(--type|-t) <TYPE>]
agents resource show <RESOURCE>
agents resource inspect [--tree] [--file <PATH>] <RESOURCE>
agents resource tree [(--depth|-d) <N>] [(--type|-t) <TYPE>] <RESOURCE>
agents resource link-child <PARENT> <CHILD>
agents resource unlink-child [--yes|-y] <PARENT> <CHILD>
agents resource stop <NAME>
agents resource rebuild <NAME>
agents plan list [--phase <PHASE>] [--state <STATE>] [--project <PROJECT>]
[--action <ACTION>] [<REGEX>]
agents plan use [--automation-profile <PROFILE>]
[--invariant <INVARIANT>]...
[--strategy-actor <STRATEGY_ACTOR>]
[--execution-actor <EXEC_ACTOR>]
[--estimation-actor <EST_ACTOR>]
[--invariant-actor <INV_ACTOR>]
[--execution-environment <RESOURCE_NAME>]
[--execution-env-priority (fallback|override)]
[--arg/-a name=value]...
<ACTION> <PROJECT>...
agents plan execute <PLAN_ID>
agents plan apply [--yes|-y] <PLAN_ID>
agents plan status <PLAN_ID>
agents plan cancel [(--reason|-r) <REASON>] <PLAN_ID>
agents plan tree [--show-superseded] <PLAN_ID>
agents plan explain [--show-context] [--show-reasoning] <DECISION_ID>
agents plan correct --mode (revert|append) (--guidance|-g) <GUIDANCE>
[--dry-run] [--yes|-y] <DECISION_ID>
agents plan diff (--correction <CORRECTION_ATTEMPT_ID>|<PLAN_ID>)
agents plan artifacts <PLAN_ID>
agents plan prompt <PLAN_ID> <GUIDANCE>
agents plan rollback [--yes|-y] <PLAN_ID> <CHECKPOINT_ID>
agents action create --config|-c <CFG_FILE>
agents action list [(--namespace|-n) <NS>] [(--state|-s) <STATE>] [<REGEX>]
agents action show <ACTION_NAME>
agents action archive <ACTION_NAME>
agents automation-profile add --config|-c <FILE> [--update]
agents automation-profile remove [--yes|-y] <NAME>
agents automation-profile list [<REGEX>]
agents automation-profile show <NAME>
agents config set <key> <value>
agents config get <key>
agents config list [--filter-values <REGEX>] [<REGEX>]
agents invariant add [--global] [(--project|-p) PROJECT] [--plan PLAN_ID]...
[--action ACTION]... <INVARIANT_TEXT>
agents invariant list [--global] [(--project|-p) PROJECT] [--plan PLAN_ID] [--action ACTION]
[--effective] [<REGEX>]
agents invariant remove [--yes|-y] <INVARIANT_ID>
$ agents --data-dir /srv/cleveragents --config-path /srv/cleveragents/config.toml info
╭─ System Snapshot ─────────────────╮
│ CleverAgents 1.0.0 │
│ Mode: local │
│ Automation: review │
│ Status: ready │
╰───────────────────────────────────╯
╭─ Paths ───────────────────────────────╮
│ Data Dir: /srv/cleveragents │
│ Config: /srv/cleveragents/config.toml │
│ Logs: /srv/cleveragents/logs │
│ Cache: /srv/cleveragents/cache │
│ Database: /srv/cleveragents/agents.db │
╰───────────────────────────────────────╯
╭─ Runtime ──────────╮
│ PID: 4127 │
│ Uptime: 00:14:32 │
│ Python: 3.13.1 │
│ Host: devbox.local │
│ Platform: linux │
╰────────────────────╯
╭─ Projects & Sessions ─╮
│ Projects: 2 │
│ Sessions: 1 active │
│ Active Plans: 0 │
│ Actors: 3 │
╰───────────────────────╯
✓ OK Environment loaded
agents version
$ agents version
╭─ CLI Version ────╮
│ CleverAgents CLI │
│ Version: 1.0.0 │
│ Channel: stable │
│ Python: 3.13 │
╰──────────────────╯
╭─ Build ────────────────╮
│ Build Date: 2026-02-08 │
│ Commit: a17c3f9 │
│ Schema: v3 │
│ Platform: linux-x86_64 │
╰────────────────────────╯
╭─ Dependencies ─────────────────╮
│ LangGraph: 0.2.60 │
│ LangChain: 0.3.18 │
│ MCP SDK: 1.4.0 │
│ Pydantic: 2.10.4 │
╰────────────────────────────────╯
✓ OK Version reported
agents info
$ agents info
╭─ Environment ───────────────────────────────────────────────╮
│ Data Dir: /home/alex/.cleveragents │
│ Config: /home/alex/.cleveragents/config.toml │
│ Database: sqlite:///home/alex/.cleveragents/cleveragents.db │
│ Server Mode: disabled │
│ Platform: Linux 6.8.0 (x86_64) │
╰─────────────────────────────────────────────────────────────╯
╭─ Runtime ─────────────────────────╮
│ Automation: review │
│ Providers: 3 configured │
│ Sessions: 2 active │
│ Active Plans: 1 │
╰───────────────────────────────────╯
╭─ Storage ─────╮
│ Cache: 118 MB │
│ Logs: 42 MB │
│ Backups: 3 │
│ DB Size: 8 MB │
╰───────────────╯
╭─ Indexing ─────────────╮
│ Text Index: ready │
│ Vector Index: ready │
│ Graph Store: disabled │
│ Indexed Files: 1,247 │
╰────────────────────────╯
✓ OK Environment details ready
agents diagnostics
$ agents diagnostics
╭─ Checks ────────────────────────────────╮
│ Check Status Details │
│ ─────────────── ────── ────────────── │
│ Config file OK readable │
│ Database OK writable │
│ OPENAI_API_KEY WARN missing │
│ Anthropic key OK configured │
│ Disk space OK 2.1 GB free │
│ Text index OK tantivy 0.22 │
│ Vector index OK faiss (CPU) │
│ Graph store WARN not configured │
│ File permissions OK data dir r/w │
│ Git OK git 2.43.0 │
╰─────────────────────────────────────────╯
╭─ Summary ─────────╮
│ Checks: 10 total │
│ Warnings: 2 │
│ Errors: 0 │
│ Duration: 0.6s │
╰───────────────────╯
╭─ Recommendations ─────────────────────────────────────────────╮
│ - Set OPENAI_API_KEY to enable OpenAI models │
│ - Configure a graph store backend for structural code queries │
│ - Verify provider credentials via config │
╰───────────────────────────────────────────────────────────────╯
⚠ WARN 2 warnings require attention
$ agents diagnostics
╭─ Checks ────────────────────────────────────────────╮
│ Check Status Details │
│ ─────────────── ─────── ──────────────────── │
│ Config file OK readable │
│ Database ERROR locked by another process │
│ OPENAI_API_KEY OK configured │
│ Anthropic key ERROR invalid key format │
│ Disk space WARN 312 MB free (low) │
│ Text index OK tantivy 0.22 │
│ Vector index ERROR FAISS library not found │
│ Graph store OK neo4j 5.15 │
│ File permissions OK data dir r/w │
│ Git OK git 2.43.0 │
╰─────────────────────────────────────────────────────╯
╭─ Summary ─────────╮
│ Checks: 10 total │
│ Warnings: 1 │
│ Errors: 3 │
│ Duration: 1.2s │
╰───────────────────╯
╭─ Errors (must fix) ─────────────────────────────────────────────────╮
│ 1. Database is locked by PID 12847 — stop the other process or │
│ delete the lock file at ~/.cleveragents/agents.db-lock │
│ 2. Anthropic key starts with "pk-" — expected "sk-ant-" prefix │
│ Run: agents config set provider.anthropic.api-key │
│ 3. FAISS library not installed — vector search will not work │
│ Run: pip install faiss-cpu │
╰─────────────────────────────────────────────────────────────────────╯
✗ ERROR 3 errors must be resolved before CleverAgents can operate
agents init [--yes|-y]
$ agents init
Warning: This will remove all data in /home/alex/.cleveragents
Continue? [y/N]: y
╭─ Environment Reset ────────────────────────────────╮
│ Config: /home/alex/.cleveragents/config.toml │
│ Database: /home/alex/.cleveragents/cleveragents.db │
│ Backup: /home/alex/.cleveragents.backup-2026-02-08 │
│ Status: ready │
╰────────────────────────────────────────────────────╯
╭─ Defaults ──────────────────────────────────╮
│ Automation Profile: supervised │
│ Built-in Profiles: 8 loaded │
╰─────────────────────────────────────────────╯
╭─ Created ─────────────────╮
│ Config: config.toml │
│ Database: cleveragents.db │
│ Logs: logs/ │
│ Cache: cache/ │
│ Backups: backups/ │
╰───────────────────────────╯
╭─ Schema ───────────────────────╮
│ Version: v3 │
│ Tables: 12 created │
│ Migrations: up to date │
╰────────────────────────────────╯
✓ OK Environment initialized
$ agents init --yes
╭─ Initialized ──────────────────────────────────────────╮
│ Data Dir: /home/alex/.cleveragents (created) │
│ Config: /home/alex/.cleveragents/config.toml │
│ Database: initialized (schema v3) │
│ Directories: logs, cache, sessions, contexts │
╰────────────────────────────────────────────────────────╯
✓ OK Initialized (non-interactive)
agents session create [--actor <ACTOR>]
$ agents session create --actor local/orchestrator
╭─ Session ───────────────────────╮
│ ID: 01HXM2A6K1P2E9Q9D4GQ7J4S7Z │
│ Actor: local/orchestrator │
│ Created: 2026-02-08 12:44 │
│ Namespace: local │
╰─────────────────────────────────╯
╭─ Settings ─────────────╮
│ Automation: review │
│ Streaming: off │
│ Context: default │
│ Memory: enabled │
│ Max History: 50 turns │
╰────────────────────────╯
╭─ Actor Details ───────────────────╮
│ Provider: anthropic │
│ Model: claude-3.5 │
│ Temperature: 0.7 │
│ Context Window: 200K tokens │
╰───────────────────────────────────╯
✓ OK Session created
agents session list
$ agents --format table session list
╭─ Sessions ───────────────────────────────────────────────────────────────────╮
│ ID Name Actor Messages Updated │
│ ──────── ─────────────── ────────────────── ──────── ──────────────── │
│ 01HXM2A6 weekly-planning local/orchestrator 6 2026-02-08 12:44 │
│ 01HXM1F2 refactor-sprint local/orchestrator 14 2026-02-07 18:11 │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Summary ────────────────────╮
│ Total: 2 │
│ Most Recent: weekly-planning │
│ Oldest: refactor-sprint │
│ Total Messages: 20 │
│ Storage: 42 KB │
╰──────────────────────────────╯
✓ OK 2 sessions listed
agents session show <SESSION_ID>
$ agents session show 01HXM2A6K1P2E9Q9D4GQ7J4S7Z
╭─ Session Summary ───────────────╮
│ ID: 01HXM2A6K1P2E9Q9D4GQ7J4S7Z │
│ Actor: local/orchestrator │
│ Messages: 6 │
│ Created: 2026-02-08 12:30 │
│ Updated: 2026-02-08 12:44 │
│ Automation: review │
╰─────────────────────────────────╯
╭─ Recent Messages ──────────────────────────────────╮
│ user Create an action to refresh dependency locks │
│ assistant Plan created, running commands... │
│ assistant Completed 2 commands │
╰────────────────────────────────────────────────────╯
╭─ Linked Plans ────────────────────────────────╮
│ Plan ID Phase State │
│ ────────────────────────── ────── ──────── │
│ 01HXM8C2ZK4Q7C2B3F2R4VYV6J execute complete │
╰───────────────────────────────────────────────╯
╭─ Token Usage ──────────────╮
│ Input Tokens: 3,420 │
│ Output Tokens: 1,185 │
│ Estimated Cost: $0.0184 │
╰────────────────────────────╯
✓ OK Session details loaded
agents session delete [--yes|-y] <SESSION_ID>
$ agents session delete 01HXM2A6K1P2E9Q9D4GQ7J4S7Z
Delete session 01HXM2A6K1P2E9Q9D4GQ7J4S7Z? [y/N]: y
╭─ Deletion Summary ──────────────────╮
│ Session: 01HXM2A6K1P2E9Q9D4GQ7J4S7Z │
│ ID: 01HXM2A6K1P2E9Q9D4GQ7J4S7Z │
│ Messages: 6 removed │
│ Storage: 18 KB freed │
│ Plans Orphaned: 0 │
╰─────────────────────────────────────╯
╭─ Cleanup ───────────╮
│ Backups: none │
│ Logs: preserved │
│ Context: cleared │
│ Checkpoints: none │
╰─────────────────────╯
✓ OK Session deleted
agents session export [(--output|-o) <FILE>] <SESSION_ID>
$ agents session export --output /tmp/weekly-planning.json 01HXM2A6K1P2E9Q9D4GQ7J4S7Z
╭─ Session Export ────────────────────╮
│ Session: 01HXM2A6K1P2E9Q9D4GQ7J4S7Z │
│ Output: /tmp/weekly-planning.json │
│ Messages: 6 │
│ Size: 24 KB │
│ Format: JSON │
╰─────────────────────────────────────╯
╭─ Contents ─────────────────╮
│ Messages: 6 │
│ Plan References: 1 │
│ Metadata Keys: 2 │
│ Actor Config: included │
│ Schema Version: v3 │
╰────────────────────────────╯
╭─ Integrity ──────────────────╮
│ Checksum: sha256:7a9b...42c1 │
│ Encrypted: no │
╰──────────────────────────────╯
✓ OK Export completed
agents session import (--input|-i) <FILE>
$ agents session import --input /tmp/weekly-planning.json
╭─ Session Import ────────────────────────╮
│ Input: /tmp/weekly-planning.json │
│ Session ID: 01HXM3D3B2W4CQYQ3P4ZB8A5T1 │
│ Messages: 6 │
│ Schema: v3 │
╰─────────────────────────────────────────╯
╭─ Validation ────────────╮
│ Checksum: verified │
│ Schema: compatible │
│ Actor Ref: resolved │
╰─────────────────────────╯
╭─ Merge ──────────────╮
│ Existing: none │
│ Strategy: create new │
╰──────────────────────╯
✓ OK Import completed
agents session tell --session <SESSION_ID> [--actor <ACTOR>] [--stream] <PROMPT>
$ agents session tell "Create an action to refresh dependency locks and add it to the platform project" \
--session 01HXM2A6K1P2E9Q9D4GQ7J4S7Z
╭─ Plan Request ──────────────────────────────────────────╮
│ Actor: local/orchestrator │
│ Session: 01HXM2A6K1P2E9Q9D4GQ7J4S7Z │
│ Automation: review │
│ Prompt: Create an action to refresh dependency locks... │
╰─────────────────────────────────────────────────────────╯
╭─ Commands Executed ─────────────────────────────────────────────────────────────────────────────────────────╮
│ - agents action create --config ./actions/refresh-locks.yaml │
│ - agents resource add git-checkout local/platform-repo --path /repos/platform │
│ - agents project link-resource local/platform local/platform-repo │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Result ──────────────────────────╮
│ Action: local/refresh-locks │
│ Project: local/platform │
│ Resource: local/platform-repo │
╰───────────────────────────────────╯
╭─ Usage ─────────────────────╮
│ Input Tokens: 1,842 │
│ Output Tokens: 624 │
│ Cost: $0.0094 │
│ Duration: 3.2s │
│ Tool Calls: 3 │
╰─────────────────────────────╯
✓ OK Orchestrator completed 3 commands
$ agents session tell --session 01HXM2A6K1 --stream "What files were changed in the last plan?"
╭─ Session ──────────────────────────╮
│ ID: 01HXM2A6K1P2E9Q9D4GQ7J4S7Z │
│ Actor: local/orchestrator │
│ Mode: streaming │
╰────────────────────────────────────╯
▍ The last plan (01HXM8C2ZK) modified 6 files in the auth module:
1. `src/auth/session.py` — refactored session validation
2. `src/auth/tokens.py` — updated token expiry to 7200s
3. `src/auth/__init__.py` — updated exports
4. `tests/test_auth.py` — added 12 new test cases
5. `tests/test_session.py` — updated session fixtures
6. `docs/auth.md` — updated API documentation
All changes passed validation (24/24 tests, lint clean).
╭─ Usage ──────────────────╮
│ Tokens: 1,240 (stream) │
│ Duration: 3.1s │
│ Tool Calls: 2 │
╰──────────────────────────╯
✓ OK Stream complete
agents project create [(--description|-d) <DESC>] [--resource <RESOURCE>]...
[--invariant <INVARIANT>]... [--invariant-actor <ACTOR>] <NAME>
$ agents project create --description "Backend API" local/api-service
╭─ Project ──────────────────────╮
│ Name: local/api-service │
│ Description: Backend API │
│ Type: local │
│ Created: 2026-02-08 12:46 │
╰────────────────────────────────╯
╭─ Paths ────────────────────────────────────╮
│ Root: /repos/api-service │
│ Data Dir: /repos/api-service/.cleveragents │
╰────────────────────────────────────────────╯
╭─ Defaults ──────────────────────────────╮
│ Sandbox: git_worktree │
│ Validations: 0 │
│ Context Filters: none │
│ Automation Profile: (inherits global) │
╰─────────────────────────────────────────╯
╭─ Resources ──────╮
│ Total: 0 │
│ Indexed: 0 │
│ Sandboxable: 0 │
╰──────────────────╯
✓ OK Project created
$ agents project create -d "Frontend web application" \
--resource local/web-repo --resource local/web-db \
--invariant "All components must have unit tests" \
--invariant "CSS must pass stylelint checks" \
--invariant-actor local/invariant-resolver \
local/web-app
╭─ Project Created ─────────────────────╮
│ Name: local/web-app │
│ Description: Frontend web app │
│ Remote: no │
╰───────────────────────────────────────╯
╭─ Linked Resources ───────────────────────────────────────╮
│ Name Type Read-Only │
│ ───────────────── ────────────── ───────── │
│ local/web-repo git-checkout no │
│ local/web-db local/database no │
╰──────────────────────────────────────────────────────────╯
╭─ Invariants ────────────────────────────────────╮
│ 1. All components must have unit tests │
│ 2. CSS must pass stylelint checks │
│ Reconciliation Actor: local/invariant-resolver │
╰─────────────────────────────────────────────────╯
✓ OK Project created
agents project link-resource [--read-only] <PROJECT> <RESOURCE>
$ agents resource add git-checkout local/api-repo --path /repos/api --branch main
$ agents project link-resource local/api-service local/api-repo
╭─ Resource Linked ───────────────────────╮
│ Project: local/api-service │
│ Resource: local/api-repo │
│ Type: git-checkout │
│ Read-Only: no │
╰─────────────────────────────────────────╯
╭─ Access ─────────────────╮
│ Read: allowed │
│ Write: allowed │
│ Apply: requires approval │
╰──────────────────────────╯
╭─ Indexing ─────────────────────╮
│ Status: indexing... │
│ Files Found: 347 │
│ Language: Python (primary) │
│ Estimated Time: ~20 seconds │
╰────────────────────────────────╯
✓ OK Resource linked to project
agents project unlink-resource [--yes|-y] <PROJECT> <RESOURCE_NAME>
$ agents project unlink-resource local/api-service local/api-repo
Unlink local/api-repo from local/api-service? [y/N]: y
╭─ Resource Unlinked ─────────────────────────────────╮
│ Project: local/api-service │
│ Resource: local/api-repo │
│ Type: git-checkout │
╰─────────────────────────────────────────────────────╯
╭─ Index Cleanup ──────────╮
│ Text Index: 347 removed │
│ Vectors: 892 removed │
│ Graph Triples: cleared │
│ Duration: 0.3s │
╰──────────────────────────╯
╭─ Project Summary ──────────────╮
│ Linked Resources: 1 remaining │
│ Last Updated: 2026-02-09 10:30 │
│ Active Plans: 0 │
╰────────────────────────────────╯
✓ OK Resource unlinked from project
agents project list [(--namespace|-n) NS] [<REGEX>]
$ agents --format table project list
╭─ Projects ────────────────────────────────────────────────────╮
│ Name Resources Remote Active Plans │
│ ───────────────── ───────── ────── ──────────── │
│ local/api-service 2 No 1 │
│ local/docs 1 No 0 │
╰───────────────────────────────────────────────────────────────╯
╭─ Summary ──────────────────╮
│ Total: 2 │
│ With Resources: 2 │
│ Remote: 0 │
│ Total Resources: 3 │
│ Indexed Files: 1,247 │
│ Active Plans: 1 │
╰────────────────────────────╯
✓ OK 2 projects listed
agents project show <PROJECT>
$ agents project show local/api-service
╭─ Project Details ──────────────╮
│ Name: local/api-service │
│ Description: Backend API │
│ Resources: 2 │
│ Remote: no │
│ Created: 2026-02-08 12:46 │
╰────────────────────────────────╯
╭─ Linked Resources ──────────────────────────────────────────────────────╮
│ Resource Type Sandbox Read-Only │
│ ──────────────── ────────────── ──────────────────── ───────── │
│ local/api-repo git-checkout git_worktree no │
│ local/staging-db local/database transaction_rollback yes │
╰─────────────────────────────────────────────────────────────────────────╯
╭─ Validations (3) ──────────────────────────────────────────────────────────────────╮
│ local/run-tests Run unit tests with coverage required │
│ resource: local/api-repo scope: project (attachment: 01HXM5A1B2C3D4E5F6G7…) │
│ local/lint-check Lint check required │
│ resource: local/api-repo scope: direct (always active) (attachment: 01HXM5…) │
│ local/check-bundle-size Check bundle size (advisory) informational │
│ resource: local/api-repo scope: project (attachment: 01HXM5D4E5F6G7H8J9…) │
╰────────────────────────────────────────────────────────────────────────────────────╯
╭─ Context ───────────────────╮
│ Include: repo │
│ Exclude: **/node_modules/** │
│ Max File Size: 1 MB │
╰─────────────────────────────╯
╭─ Indexing Status ──────────╮
│ Text Index: ready │
│ Vector Index: ready │
│ Graph Store: disabled │
│ Indexed Files: 347 │
│ Last Indexed: 12:48 │
╰────────────────────────────╯
╭─ Active Plans ──────────────────────────╮
│ Plan ID Action Phase │
│ ──────── ─────────────────── ─────── │
│ 01HXM7A9 local/code-coverage execute │
╰─────────────────────────────────────────╯
✓ OK Project loaded
agents project delete [--force|-f] [--yes|-y] <NAME>
$ agents project delete local/docs
Delete project local/docs? This cannot be undone. [y/N]: y
╭─ Deletion Summary ──────────────────╮
│ Project: local/docs │
│ Resources: 1 unlinked │
│ Data Dir: /repos/docs/.cleveragents │
╰─────────────────────────────────────╯
╭─ Index Cleanup ────────╮
│ Text Index: cleared │
│ Vectors: 240 removed │
│ Graph Triples: none │
│ Storage Freed: 12 MB │
╰────────────────────────╯
╭─ Backups ────────────────────────────────────╮
│ Snapshot: /backups/local-docs-2026-02-08.tgz │
│ Retention: 7 days │
╰──────────────────────────────────────────────╯
✓ OK Project deleted
$ agents project delete local/api-service
Delete project local/api-service? [y/N]: y
╭─ Delete Blocked ──────────────────────────────────────────╮
│ Cannot delete: project has active plans │
│ Active Plans: 2 │
│ 01HXM7A9 — execute/processing (local/code-coverage) │
│ 01HXM4J1 — strategize/processing (local/refactor-api) │
╰───────────────────────────────────────────────────────────╯
╭─ Resolution ──────────────────────────────────────────────────────╮
│ - Cancel or complete active plans first, or │
│ - Use --force to cancel all active plans and delete the project │
╰───────────────────────────────────────────────────────────────────╯
✗ ERROR Delete blocked — 2 active plans
$ agents project delete --force --yes local/api-service
╭─ Force Delete ─────────────────────────────────────────╮
│ Cancelling: 2 active plans │
│ 01HXM7A9 — cancelled (was execute/processing) │
│ 01HXM4J1 — cancelled (was strategize/processing) │
╰────────────────────────────────────────────────────────╯
╭─ Deleted ────────────────────╮
│ Project: local/api-service │
│ Resources Unlinked: 2 │
│ Validations Detached: 3 │
│ Plans Cancelled: 2 │
│ Context Policies: cleared │
╰──────────────────────────────╯
✓ OK Project force-deleted
agents project context set[--view (strategize|execute|apply|default)]
[--include-resource <INCLUDE_RESOURCE>]...
[--exclude-resource <EXCLUDE_RESOURCE>]...
[--include-path <INCLUDE_GLOB>]...
[--exclude-path <EXCLUDE_GLOB>]...
[--hot-max-tokens <N>]
[--warm-max-decisions <N_WARM_MAX>]
[--cold-max-decisions <N_COLD_MAX>]
[--query-limit <N>]
[--max-file-size <MAX_FILE_BYTES>]
[--max-total-size <MAX_TOTAL_BYTES>]
[--summarize|--no-summarize]
[--summary-max-tokens <N>]
[--strategy <STRATEGY>]...
[--default-breadth <N>]
[--default-depth <INT_OR_NAME>]
[--depth-gradient <HOP:INT_OR_NAME>]...
[--skeleton-ratio <FLOAT>]
[--temporal-scope (current|recent|all)]
[--auto-refresh|--no-auto-refresh]
[--execution-environment <RESOURCE_NAME>]
[--execution-env-priority (fallback|override)]
[--clear] <PROJECT>
$ agents project context set --view strategize \
--include-resource repo --exclude-path "**/node_modules/**" \
--hot-max-tokens 12000 --warm-max-decisions 50 --cold-max-decisions 200 \
--summarize --summary-max-tokens 800 local/api-service
╭─ Context Policy ────────────╮
│ Project: local/api-service │
│ View: strategize │
│ Include: repo │
│ Exclude: **/node_modules/** │
╰─────────────────────────────╯
╭─ Limits ─────────────────────╮
│ Hot Tokens: 12000 (soft cap) │
│ Warm Decisions: 50 │
│ Cold Decisions: 200 │
│ Query Limit: 20 │
│ Max File Size: 1 MB │
│ Max Total Size: 50 MB │
╰──────────────────────────────╯
╭─ Summarization ─╮
│ Enabled: yes │
│ Max Tokens: 800 │
╰─────────────────╯
╭─ Other Views ────────╮
│ execute: (default) │
│ apply: (default) │
│ default: (unset) │
╰──────────────────────╯
✓ OK Context policy updated
agents project context show [--view (strategize|execute|apply|default)]
<PROJECT>
$ agents project context show --view strategize local/api-service
╭─ Context Policy ────────────╮
│ Project: local/api-service │
│ View: strategize │
│ Include: repo │
│ Exclude: **/node_modules/** │
╰─────────────────────────────╯
╭─ Limits ─────────────────────╮
│ Hot Tokens: 12000 (soft cap) │
│ Warm Decisions: 50 │
│ Cold Decisions: 200 │
│ Query Limit: 20 │
│ Max File Size: 1 MB │
│ Max Total Size: 50 MB │
╰──────────────────────────────╯
╭─ Summarization ─╮
│ Enabled: yes │
│ Max Tokens: 800 │
╰─────────────────╯
╭─ Current Usage ──────────────╮
│ Hot Context: 8,420 / 12,000 │
│ Warm Entries: 12 / 50 │
│ Cold Entries: 47 / 200 │
│ Indexed Resources: 1 │
╰──────────────────────────────╯
✓ OK Context policy loaded
agents project context inspect [--view (strategize|execute|apply|default)]
[--strategy <STRATEGY>]
[--focus <UKO_URI>]...
[--breadth <N>] [--depth <INT_OR_NAME>]
<PROJECT>
$ agents project context inspect --view execute --focus uko-py:module/src.auth --breadth 2 local/api-service
╭─ ACMS Context Inspection ────────────────────────────────────────╮
│ Project: local/api-service │
│ View: execute │
│ Focus: uko-py:module/src.auth │
│ Breadth: 2 hops │ Depth: 3 (MEMBER_SUMMARY) │
╰──────────────────────────────────────────────────────────────────╯
╭─ UKO Graph (2-hop neighborhood) ─────────────────────────────────╮
│ uko-py:module/src.auth (depth 9/FULL_SOURCE, 1,240 tokens) │
│ ├─ contains → uko-py:class/AuthHandler (depth 3, 320 tokens) │
│ ├─ contains → uko-py:class/TokenValidator (depth 3, 280 tok) │
│ ├─ imports → uko-py:module/src.db (depth 0, 90 tokens) │
│ └─ imports → uko-py:module/src.config (depth 0, 60 tok) │
╰──────────────────────────────────────────────────────────────────╯
╭─ Active Strategies ──────────────────────────────────────────────╮
│ breadth-depth-navigator quality=0.85 budget=45% 4 fragments │
│ semantic-embedding quality=0.60 budget=35% 6 fragments │
│ simple-keyword quality=0.30 budget=20% 3 fragments │
╰──────────────────────────────────────────────────────────────────╯
╭─ Budget ─────────────────────────────╮
│ Model Window: 128,000 tokens │
│ Response Reserve: 4,096 tokens │
│ Tool Definitions: 2,400 tokens │
│ System Prompt: 1,200 tokens │
│ Skeleton Reserve: 18,046 (15%) │
│ Available Budget: 102,258 tokens │
│ Used: 1,990 / 102,258 (1.9%) │
╰──────────────────────────────────────╯
✓ OK Context inspection complete
agents project context simulate [--view (strategize|execute|apply|default)]
[--budget <TOKENS>]
[--focus <UKO_URI>]...
[--strategy <STRATEGY>]...
<PROJECT>
$ agents project context simulate --view strategize --budget 16000 \
--focus uko-py:module/src.auth --focus uko-py:module/src.db \
local/api-service
╭─ ACMS Simulation ────────────────────────────────────────────────╮
│ Project: local/api-service │
│ View: strategize │
│ Budget: 16,000 tokens (override) │
│ Focus: uko-py:module/src.auth, uko-py:module/src.db │
╰──────────────────────────────────────────────────────────────────╯
╭─ Strategy Results ───────────────────────────────────────────────╮
│ breadth-depth-navigator │
│ Confidence: 0.85 │ Budget: 7,200 tokens │ 12 fragments │
│ Top: src/auth/__init__.py (depth 9, 1,240t, score=0.95) │
│ src/db/models.py (depth 3, 480t, score=0.88) │
│ │
│ semantic-embedding │
│ Confidence: 0.60 │ Budget: 5,600 tokens │ 8 fragments │
│ Top: src/auth/jwt.py (depth 3, 380t, score=0.82) │
│ src/middleware/auth_check.py (depth 3, 290t, score=0.79) │
│ │
│ simple-keyword │
│ Confidence: 0.30 │ Budget: 3,200 tokens │ 5 fragments │
│ Top: src/auth/utils.py (depth 6, 210t, score=0.71) │
╰──────────────────────────────────────────────────────────────────╯
╭─ Fusion Result ──────────────────────────────────────────────────╮
│ Included: 18 fragments (14,820 tokens, 92.6% of budget) │
│ Excluded: 7 fragments (3,200 tokens, below budget cutoff) │
│ Deduplicated: 4 fragments merged │
│ Skeleton: 2,400 tokens (15% reserve) │
│ Preamble: 180 tokens │
╰──────────────────────────────────────────────────────────────────╯
✓ OK Simulation complete (dry run — no context was assembled)
agents actor run [(--output|-o) <OUTPUT_FILE>]
[-v...] [--unsafe|-u] [--context <CONTEXT_NAME>]
[--context-dir <CONTEXT_PATH>] [--load-context <LOAD_CONTEXT_NAME>]
[(--temperature|-t) <TEMP>] [--allow-rxpy-in-run-mode]
[--skill <SKILL>]... <NAME> <PROMPT>
$ agents actor run --context docs local/code_reader "Summarize the README"
╭─ Run Summary ─────────────────╮
│ Actor: local/code_reader │
│ Context: docs │
│ Temperature: 0.2 │
│ Provider: anthropic │
│ Model: claude-3.5 │
╰───────────────────────────────╯
╭─ Inputs ─────────────────────╮
│ Prompt: Summarize the README │
│ Context Files: 3 │
│ Context Size: 12.4 KB │
╰──────────────────────────────╯
╭─ Result Metrics ───────╮
│ Output: stdout │
│ Input Tokens: 1,524 │
│ Output Tokens: 842 │
│ Duration: 1.8s │
│ Cost: $0.0021 │
│ Tool Calls: 0 │
╰────────────────────────╯
✓ OK Summary generated
$ agents actor run --temperature 0.2 --skill local/code-analysis \
local/reviewer "Review the auth module for security issues"
╭─ Actor Run ─────────────────────────╮
│ Actor: local/reviewer │
│ Type: agent │
│ Temperature: 0.2 │
│ Skill: local/code-analysis │
╰─────────────────────────────────────╯
╭─ Response ────────────────────────────────────────────────────────╮
│ I identified 3 potential security concerns in the auth module: │
│ │
│ 1. Token expiry not validated in `validate_session()` at │
│ src/auth/session.py:42. The JWT expiry claim is decoded but │
│ not checked against current time. │
│ │
│ 2. Missing rate limiting on the `/auth/refresh` endpoint. │
│ An attacker could brute-force refresh tokens. │
│ │
│ 3. Low severity: Password hashing uses bcrypt with cost=10. │
│ Consider cost=12 for production deployments. │
╰───────────────────────────────────────────────────────────────────╯
╭─ Usage ──────────────╮
│ Tokens: 2,840 │
│ Duration: 4.2s │
│ Cost: $0.009 │
│ Tool Calls: 6 │
╰──────────────────────╯
✓ OK Actor run completed
$ agents actor run --output review.md local/reviewer "Write a code review report"
╭─ Actor Run ───────────────╮
│ Actor: local/reviewer │
│ Output: review.md │
│ Tokens: 4,120 │
│ Duration: 6.8s │
╰───────────────────────────╯
✓ OK Output written to review.md (2.4 KB)
agents actor add --config|-c <FILE> [--update]
$ agents actor add --config ./actors/reviewer.yaml
╭─ Actor Added ────────╮
│ Name: local/reviewer │
│ Provider: openai │
│ Model: gpt-4 │
│ Default: yes │
│ Unsafe: no │
│ Type: graph │
╰──────────────────────╯
╭─ Config ─────────────────────╮
│ Path: ./actors/reviewer.yaml │
│ Hash: 8b3f3d2 │
│ Options: 4 │
│ Nodes: 3 │
│ Edges: 4 │
╰──────────────────────────────╯
╭─ Capabilities ───────╮
│ - code review │
│ - diff summarization │
│ - lint guidance │
╰──────────────────────╯
╭─ Tools ────────────────────────╮
│ Tool Read-Only Safe │
│ ──────────── ───────── ──── │
│ read_file yes yes │
│ search_files yes yes │
│ git_diff yes yes │
╰────────────────────────────────╯
✓ OK Actor added
$ agents actor add --config ./actors/reviewer.yaml
╭─ Error ─────────────────────────────────────────────────╮
│ Actor already exists: local/reviewer │
│ Registered: 2026-02-07 14:22 │
│ Use --update to replace the existing actor definition. │
╰─────────────────────────────────────────────────────────╯
✗ ERROR Actor already registered — use --update to replace
$ agents actor add --config ./actors/reviewer.yaml --update
╭─ Actor Updated ─────────────────────╮
│ Name: local/reviewer │
│ Type: agent │
│ Status: updated │
╰─────────────────────────────────────╯
╭─ Changes ────────────────────────────╮
│ Skills: +1 (local/code-analysis) │
│ Model: unchanged │
│ Graph: updated │
╰──────────────────────────────────────╯
✓ OK Actor updated
agents actor remove <NAME>
$ agents actor remove local/reviewer
╭─ Actor Removed ──────╮
│ Name: local/reviewer │
│ Provider: openai │
│ Model: gpt-4 │
╰──────────────────────╯
╭─ Impact ───────────────────────────────────╮
│ Sessions: 0 affected │
│ Active Plans: 0 affected │
│ Actions Referencing: 0 │
╰────────────────────────────────────────────╯
╭─ Cleanup ──────────────╮
│ Config: kept on disk │
│ Contexts: 1 orphaned │
╰────────────────────────╯
✓ OK Actor removed
agents actor list
$ agents actor list
╭─ Actors ──────────────────────────────────────────────────────────────╮
│ Name Provider Model Default Built-in Unsafe │
│ ────────────── ───────── ────────── ─────── ──────── ────── │
│ local/reviewer openai gpt-4 ✓ no │
│ openai/gpt-4 openai gpt-4 ✓ no │
│ anthropic/3.5 anthropic claude-3.5 ✓ no │
╰───────────────────────────────────────────────────────────────────────╯
╭─ Summary ──────────────╮
│ Total: 3 │
│ Built-in: 2 │
│ Custom: 1 │
│ Unsafe: 0 │
│ Providers Used: 2 │
╰────────────────────────╯
✓ OK 3 actors listed
agents actor show <NAME>
$ agents actor show local/reviewer
╭─ Actor Details ────────────────────╮
│ Name: local/reviewer │
│ Provider: openai │
│ Model: gpt-4 │
│ Default: yes │
│ Built-in: no │
│ Unsafe: no │
│ Type: graph │
│ Created: 2026-02-08 12:35 │
│ Updated: 2026-02-08 12:40 │
│ Config: ./actors/reviewer.yaml │
│ Config Hash: 9c4e2a1 │
╰────────────────────────────────────╯
╭─ Options ──────────╮
│ - temperature: 0.2 │
│ - max_tokens: 2048 │
│ - top_p: 1.0 │
╰────────────────────╯
╭─ Graph Structure ─╮
│ Nodes: 3 │
│ Edges: 4 │
│ Entry: analyze │
│ Exit: report │
╰───────────────────╯
╭─ Tools ────────────────────────╮
│ Tool Read-Only Safe │
│ ──────────── ───────── ──── │
│ read_file yes yes │
│ search_files yes yes │
│ git_diff yes yes │
╰────────────────────────────────╯
╭─ Access ────────────╮
│ Unsafe: no │
│ Filesystem: allowed │
│ Network: restricted │
╰─────────────────────╯
╭─ Usage ─────────────────────────────────────────╮
│ Referenced by Actions: 1 (local/code-coverage) │
│ Active in Sessions: 0 │
│ Total Runs: 14 │
│ Avg Cost/Run: $0.0032 │
╰─────────────────────────────────────────────────╯
✓ OK Actor loaded
agents actor context remove [--yes|-y] (--all|-a|<NAME>)
$ agents actor context remove docs
╭─ Context Removed ───────────╮
│ Context: docs │
│ Status: removed │
╰─────────────────────────────╯
╭─ Stats ───────────────────╮
│ Remaining Size: 48 KB │
│ Updated: 2026-02-08 13:06 │
╰───────────────────────────╯
✓ OK Context updated
agents actor context list [<REGEX>]
$ agents actor context list docs
╭─ Context Files ──────────────────────────────╮
│ Name Type Size Added │
│ ──────────────── ──── ─────── ────────── │
│ README.md file 4.2 KB 02-08 12:10 │
│ docs/overview.md file 12.8 KB 02-08 12:10 │
│ docs/cli.md file 9.5 KB 02-08 12:10 │
╰──────────────────────────────────────────────╯
╭─ Stats ───────────────────────╮
│ Total Files: 3 │
│ Total Size: 26.5 KB │
│ Estimated Tokens: ~6,600 │
│ Languages: Markdown │
╰───────────────────────────────╯
✓ OK 3 files listed
agents actor context show <NAME>
$ agents actor context show docs
╭─ Context Summary ───────────╮
│ Context: docs │
│ Files: 3 │
│ Total Size: 26.5 KB │
│ Estimated Tokens: ~6,600 │
│ Created: 2026-02-08 12:10 │
╰─────────────────────────────╯
✓ OK Context displayed
agents actor context export (--output|-o) <FILE> <NAME>
$ agents actor context export --output /tmp/docs-context.json docs
╭─ Context Export ───────────────╮
│ Context: docs │
│ Output: /tmp/docs-context.json │
│ Items: 12 │
│ Size: 48 KB │
╰────────────────────────────────╯
╭─ Integrity ──────────────────╮
│ Checksum: sha256:19b2...a7d0 │
│ Compressed: no │
╰──────────────────────────────╯
✓ OK Export completed
agents actor context import [--update] (--input|-i) <FILE> [<NAME>]
$ agents actor context import --input /tmp/docs-context.json docs
╭─ Context Import ──────────────╮
│ Context: docs │
│ Input: /tmp/docs-context.json │
│ Items: 12 │
╰───────────────────────────────╯
╭─ Merge ───────────╮
│ Strategy: replace │
│ Conflicts: 0 │
╰───────────────────╯
✓ OK Import completed
agents actor context clear [--yes|-y] (--all|-a|<NAME>)
$ agents actor context clear docs
Clear context docs? [y/N]: y
╭─ Context Cleared ────╮
│ Context: docs │
│ Items: 12 removed │
│ Storage: 48 KB freed │
╰──────────────────────╯
╭─ Retention ────────╮
│ Context: preserved │
│ Files: removed │
╰────────────────────╯
✓ OK Context cleared
agents skill add --config|-c <FILE> [--update]
$ agents skill add --config ./skills/devops-toolkit.yaml
╭─ Skill Registered ────────────────────────╮
│ Name: local/devops-toolkit │
│ Description: Full-stack development tools │
│ Config: ./skills/devops-toolkit.yaml │
│ Created: 2026-02-08 13:10 │
╰───────────────────────────────────────────╯
╭─ Includes ────────────────────╮
│ local/file-ops (registered) │
│ local/git-ops (registered) │
│ local/github (registered) │
╰───────────────────────────────╯
╭─ Tool Sources ────────────────────────────────╮
│ Source Count Details │
│ ───────────── ───── ─────────────────── │
│ builtin 14 file, dir, git, shell │
│ mcp 6 github (4), linear (2) │
│ agent_skill 2 deploy, code-review │
│ custom 1 run_migrations │
│ ───────────── ───── ─────────────────── │
│ Total: 23 │
╰───────────────────────────────────────────────╯
╭─ MCP Servers ────────────────────╮
│ linear: validated (2 tools) │
╰──────────────────────────────────╯
✓ OK Skill registered with 23 tools
$ agents skill add --config ./skills/devops-toolkit-v2.yaml
✗ Error: Skill 'local/devops-toolkit' is already registered.
To overwrite the existing configuration, re-run with --update:
agents skill add --config ./skills/devops-toolkit-v2.yaml --update
$ agents skill add --config ./skills/devops-toolkit-v2.yaml --update
╭─ Skill Updated ───────────────────────────╮
│ Name: local/devops-toolkit │
│ Description: Full-stack development tools │
│ Updated: 2026-02-08 14:22 │
╰───────────────────────────────────────────╯
╭─ Changes ─────────────────────╮
│ Tools Added: 2 │
│ Tools Removed: 0 │
│ Tools Modified: 1 │
│ Includes Changed: no │
│ MCP Servers Changed: no │
╰───────────────────────────────╯
╭─ Affected Actors ─────────────────────────────╮
│ Warning: 2 actors reference this skill: │
│ - local/code-assistant │
│ - local/full-stack-assistant │
│ These actors will pick up changes on next use │
╰───────────────────────────────────────────────╯
✓ OK Skill updated (23 → 25 tools)
agents skill remove [--yes|-y] <NAME>
$ agents skill remove local/devops-toolkit
Remove skill local/devops-toolkit? [y/N]: y
╭─ Skill Removed ──────────────────────╮
│ Name: local/devops-toolkit │
│ Tools: 23 removed from registry │
│ MCP Servers: 1 connection closed │
╰──────────────────────────────────────╯
╭─ Dependency Check ─────────────────────────────────╮
│ Warning: 1 skill includes this skill: │
│ - local/full-stack-dev (will lose devops tools) │
│ Warning: 2 actors reference this skill: │
│ - local/code-assistant │
│ - local/full-stack-assistant │
╰────────────────────────────────────────────────────╯
✓ OK Skill removed
agents skill list [(--namespace|-n) <NS>] [--source <SOURCE>]
$ agents skill list
╭─ Skills ────────────────────────────────────────────────────────────╮
│ Name Tools Includes Sources │
│ ────────────────────── ───── ──────── ────────────────────── │
│ local/file-ops 9 0 builtin │
│ local/git-ops 4 0 builtin │
│ local/github 4 0 mcp │
│ local/devops-toolkit 23 3 builtin, mcp, custom │
│ local/full-stack-dev 25 4 builtin, mcp, custom │
╰─────────────────────────────────────────────────────────────────────╯
╭─ Summary ─────────╮
│ Total: 5 │
│ Local: 5 │
│ Server: 0 │
│ Total Tools: 28 │
╰───────────────────╯
✓ OK 5 skills listed
agents skill show <NAME>
$ agents skill show local/devops-toolkit
╭─ Skill Details ──────────────────────────────╮
│ Name: local/devops-toolkit │
│ Description: Full-stack development tools │
│ Config: ./skills/devops-toolkit.yaml │
│ Created: 2026-02-08 13:10 │
│ Updated: 2026-02-08 14:22 │
╰──────────────────────────────────────────────╯
╭─ Includes (3) ────────────────────────────╮
│ local/file-ops → 9 tools (builtin) │
│ local/git-ops → 4 tools (builtin) │
│ local/github → 4 tools (mcp) │
╰───────────────────────────────────────────╯
╭─ Direct Tools (6) ────────────────────────────────────────╮
│ Name Source Writes Checkpoint │
│ ──────────────── ─────────── ────── ────────── │
│ create_issue mcp:linear yes no │
│ list_issues mcp:linear no — │
│ deploy-to-staging agent_skill yes composite │
│ code-review agent_skill no — │
│ run_migrations custom yes transaction │
│ shell_execute builtin yes snapshot │
╰───────────────────────────────────────────────────────────╯
╭─ MCP Servers (1) ───────────────────╮
│ linear: stdio, 2 tools, connected │
╰─────────────────────────────────────╯
╭─ Capability Summary ──────────╮
│ Total Tools: 23 │
│ Read-Only: 10 │
│ Writes: 13 │
│ Checkpointable: 10 │
│ Has Side Effects: 3 │
│ Requires Approval: 1 │
╰───────────────────────────────╯
╭─ Referenced By ───────────────────╮
│ Actors: local/code-assistant │
│ Skills: local/full-stack-dev │
╰───────────────────────────────────╯
✓ OK Skill loaded
agents skill tools <NAME>
$ agents skill tools local/devops-toolkit
╭─ Tools for local/devops-toolkit ─────────────────────────────────────────────────────────╮
│ Tool Source From Skill Read-Only Writes Checkpoint │
│ ───────────────── ─────────── ────────────── ───────── ────── ────────── │
│ read_file builtin local/file-ops ✓ — — │
│ write_file builtin local/file-ops — ✓ file │
│ edit_file builtin local/file-ops — ✓ file │
│ delete_file builtin local/file-ops — ✓ file │
│ move_file builtin local/file-ops — ✓ file │
│ copy_file builtin local/file-ops — ✓ file │
│ create_directory builtin local/file-ops — ✓ file │
│ list_directory builtin local/file-ops ✓ — — │
│ delete_directory builtin local/file-ops — ✓ file │
│ git_status builtin local/git-ops ✓ — — │
│ git_diff builtin local/git-ops ✓ — — │
│ git_log builtin local/git-ops ✓ — — │
│ git_blame builtin local/git-ops ✓ — — │
│ create_issue mcp:github local/github — ✓ no │
│ create_pr mcp:github local/github — ✓ no │
│ list_repos mcp:github local/github ✓ — — │
│ get_file_contents mcp:github local/github ✓ — — │
│ create_issue mcp:linear (direct) — ✓ no │
│ list_issues mcp:linear (direct) ✓ — — │
│ run_migrations custom (direct) — ✓ transaction │
│ deploy-to-staging agent_skill (direct) — ✓ composite │
│ code-review agent_skill (direct) ✓ — — │
│ shell_execute builtin (direct) — ✓ snapshot │
╰──────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Summary ──────────────────╮
│ Total: 23 │
│ From Includes: 17 │
│ Direct: 6 │
│ Read-Only: 10 │
│ Writes: 13 │
│ Checkpointable: 10 │
╰────────────────────────────╯
✓ OK 23 tools listed
agents tool add --config|-c <FILE> [--update]
$ agents tool add --config ./tools/run-migrations.yaml
╭─ Tool Registered ────────────────────────────╮
│ Name: local/run-migrations │
│ Description: Run database migrations │
│ Source: custom │
│ Config: ./tools/run-migrations.yaml │
│ Created: 2026-02-09 10:15 │
╰──────────────────────────────────────────────╯
╭─ Capability ─────────────────────╮
│ Writes: true │
│ Write Scope: database:migrations │
│ Checkpointable: true │
│ Checkpoint Scope: transaction │
│ Side Effects: schema_mutation │
╰──────────────────────────────────╯
✓ OK Tool registered
$ agents tool add --config ./tools/run-migrations-v2.yaml
✗ Error: Tool 'local/run-migrations' is already registered.
To overwrite the existing configuration, re-run with --update:
agents tool add --config ./tools/run-migrations-v2.yaml --update
$ agents tool add --config ./tools/db-migrate.yaml --update
╭─ Tool Updated ─────────────────────────────╮
│ Name: local/db-migrate │
│ Source: custom (Python) │
│ Status: updated (was version 1 → now 2) │
╰────────────────────────────────────────────╯
╭─ Changes ─────────────────────────────────────╮
│ Input Schema: modified (added batch_size) │
│ Capabilities: unchanged (writes, checkpoint) │
│ Description: updated │
╰───────────────────────────────────────────────╯
╭─ References ──────────────────╮
│ Skills: 1 (local/db-tools) │
│ Actors: 0 │
│ Referencing skills will use │
│ the updated definition. │
╰───────────────────────────────╯
✓ OK Tool updated
agents tool remove [--yes|-y] <NAME>
$ agents tool remove local/run-migrations
Remove tool local/run-migrations? [y/N]: y
╭─ Tool Removed ────────────────────╮
│ Name: local/run-migrations │
│ Source: custom │
╰───────────────────────────────────╯
╭─ References ──────────────────────────────────────╮
│ Warning: This tool is referenced by: │
│ - Skill: local/devops-toolkit │
│ - Actor graph node: code_executor.run_db_migrate │
│ These references will break until resolved. │
╰───────────────────────────────────────────────────╯
✓ OK Tool removed
$ agents tool remove local/check-bundle-size
Remove validation local/check-bundle-size? [y/N]: y
╭─ Validation Removed ─────────────────────────────╮
│ Name: local/check-bundle-size │
│ Description: Check bundle size (advisory) │
╰──────────────────────────────────────────────────╯
╭─ Detached From ────────────────────────────────────────────╮
│ Warning: This validation had 2 attachments: │
│ - local/api-repo (scope: project local/api-service) │
│ - local/api-repo (direct) │
│ These attachments have been removed. │
╰────────────────────────────────────────────────────────────╯
✓ OK Validation removed─
agents tool list [(--namespace|-n) <NS>] [--source <SOURCE>] [--type (tool|validation)] [<REGEX>]
$ agents tool list --namespace local
╭─ Tools ─────────────────────────────────────────────────────────────────╮
│ Name Type Source Read-Only Writes │
│ ───────────────────────── ────────── ─────── ───────── ────── │
│ local/run-migrations tool custom — ✓ │
│ local/validate-api-compat tool custom — ✓ │
│ local/create-subplan tool custom — ✓ │
│ local/deploy-staging tool agent — ✓ │
│ local/run-tests validation custom ✓ — │
│ local/lint-check validation custom ✓ — │
│ local/check-bundle-size validation custom ✓ — │
│ local/type-check validation custom ✓ — │
╰─────────────────────────────────────────────────────────────────────────╯
╭─ Summary ────────────────╮
│ Total: 8 │
│ Tools: 4 │
│ Validations: 4 │
│ Read-Only: 4 │
│ Writes: 4 │
╰──────────────────────────╯
✓ OK 8 tools listed
$ agents tool list --type validation --namespace local
╭─ Validations ─────────────────────────────────────────────────────────────────╮
│ Name Source Mode Attachments │
│ ───────────────────────── ─────── ──────────── ──────────────────────── │
│ local/run-tests custom required 2 (1 direct, 1 project) │
│ local/lint-check custom required 1 (1 direct) │
│ local/check-bundle-size custom informational 1 (1 project) │
│ local/type-check custom required 2 (2 project) │
╰───────────────────────────────────────────────────────────────────────────────╯
╭─ Summary ──────────────╮
│ Total: 4 │
│ Required: 3 │
│ Informational: 1 │
╰────────────────────────╯
✓ OK 4 validations listed
agents tool show <NAME>
$ agents tool show local/run-migrations
╭─ Tool Details ───────────────────────────────╮
│ Name: local/run-migrations │
│ Description: Run database migrations │
│ Source: custom │
│ Config: ./tools/run-migrations.yaml │
│ Registered: 2026-02-09 10:15 │
╰──────────────────────────────────────────────╯
╭─ Input Schema ─────────────────────────────────╮
│ direction: string (required) enum: [up, down] │
│ count: integer (default: 1) │
╰────────────────────────────────────────────────╯
╭─ Capability ──────────────────────╮
│ Read-Only: false │
│ Writes: true │
│ Write Scope: database:migrations │
│ Checkpointable: true │
│ Checkpoint Scope: transaction │
│ Side Effects: schema_mutation │
│ Idempotent: false │
╰───────────────────────────────────╯
╭─ Referenced By ───────────────────────╮
│ Skills: │
│ - local/devops-toolkit │
│ Actor Graph Nodes: │
│ - code_executor.run_db_migrate │
╰───────────────────────────────────────╯
✓ OK Tool details loaded
$ agents tool show local/run-tests
╭─ Validation Details ──────────────────────────────╮
│ Name: local/run-tests │
│ Type: validation │
│ Description: Run unit tests with coverage │
│ Source: custom │
│ Mode: required │
│ Config: ./validations/run-tests.yaml │
│ Registered: 2026-02-09 10:15 │
╰───────────────────────────────────────────────────╯
╭─ Input Schema ─────────────────────────────────────╮
│ coverage_threshold: integer (default: 80) │
╰────────────────────────────────────────────────────╯
╭─ Output Schema (Validation Return Format) ─────────╮
│ passed: boolean (required) │
│ message: string (optional) │
│ data: object (optional, arbitrary structure) │
╰────────────────────────────────────────────────────╯
╭─ Capability ──────────────────────╮
│ Read-Only: true (enforced) │
│ Checkpointable: false (enforced) │
│ Timeout: 600s │
╰───────────────────────────────────╯
╭─ Attached To ─────────────────────────────────────────────────────╮
│ local/api-repo (direct, always active) │
│ (attachment: 01HXM5B2C3D4E5F6G7H8J9K0L1) │
│ local/api-repo (scope: project local/api-service) │
│ (attachment: 01HXM5A1B2C3D4E5F6G7H8J9K0) │
╰───────────────────────────────────────────────────────────────────╯
✓ OK Validation details loaded
agents lsp add [--update|-u] (--config|-c) <FILE>
$ agents lsp add --config lsp/pyright.yaml
╭─ LSP Server Registered ──────────────────────────────────╮
│ Name: local/pyright │
│ Languages: python │
│ Command: pyright-langserver --stdio │
│ Capabilities: diagnostics, hover, completions, │
│ references, definitions, symbols, │
│ rename, code_actions │
╰──────────────────────────────────────────────────────────╯
✓ OK LSP server registered
$ agents lsp add --config lsp/pyright.yaml
✗ ERROR LSP server 'local/pyright' already exists
Hint: Use --update to overwrite: agents lsp add --update --config lsp/pyright.yaml
agents lsp remove [--yes|-y] <NAME>
$ agents lsp remove local/pyright
Remove LSP server local/pyright? [y/N]: y
╭─ LSP Server Removed ─────────────────────╮
│ Name: local/pyright │
│ Languages: python │
╰──────────────────────────────────────────╯
╭─ References ──────────────────────────────────────────────────╮
│ Warning: This LSP server is referenced by: │
│ - Actor: local/code-reviewer (lsp: [local/pyright]) │
│ - Actor: local/refactor-agent (lsp: [local/pyright]) │
│ These actor LSP bindings will fail until resolved. │
╰───────────────────────────────────────────────────────────────╯
✓ OK LSP server removed
agents lsp list [(--namespace|-n) <NS>] [--language <LANG>] [<REGEX>]
$ agents lsp list
╭─ LSP Registry (3 servers) ───────────────────────────────────────────────────────────╮
│ Name │ Languages │ Command │ Bound │
│─────────────────────────│──────────────────────│─────────────────────────────│───────│
│ local/pyright │ python │ pyright-langserver --stdio │ 3 │
│ local/ts-server │ typescript, jsx, tsx │ typescript-language-server │ 2 │
│ local/gopls │ go │ gopls serve │ 1 │
╰──────────────────────────────────────────────────────────────────────────────────────╯
$ agents lsp list --language python
╭─ LSP Registry (1 server, filtered: language=python) ─────────────────────────────╮
│ Name │ Languages │ Command │ Bound │
│─────────────────────────│────────────│───────────────────────────────────│───────│
│ local/pyright │ python │ pyright-langserver --stdio │ 3 │
╰──────────────────────────────────────────────────────────────────────────────────╯
agents lsp show <NAME>
$ agents lsp show local/pyright
╭─ LSP Server Details ──────────────────────────────────────────╮
│ Name: local/pyright │
│ Languages: python │
│ Command: pyright-langserver --stdio │
│ Root path: {{ project.root }} │
│ Init options: │
│ python.analysis.typeCheckingMode: standard │
│ python.analysis.autoSearchPaths: true │
╰───────────────────────────────────────────────────────────────╯
╭─ Capabilities ────────────────────────────────────────────────╮
│ diagnostics, hover, completions, references, definitions, │
│ symbols, rename, code_actions │
╰───────────────────────────────────────────────────────────────╯
╭─ Bound Actors ────────────────────────────────────────────────╮
│ local/code-reviewer (explicit binding) │
│ local/refactor-agent (language-based: python) │
│ local/polyglot-planner (auto-discovery) │
╰───────────────────────────────────────────────────────────────╯
agents lsp serve [--log-level <LEVEL>]
$ agents lsp serve
CleverAgents LSP Server (stub) starting — PID 7412
Log level: info
Transport: stdin/stdout (JSON-RPC, Content-Length framing)
Supported methods: initialize, shutdown, exit
All other methods → MethodNotFound (-32601)
agents validation add --config|-c <FILE> [--required | --informational] [--update]
$ agents validation add --config ./validations/run-tests.yaml
╭─ Validation Registered ────────────────────────────────╮
│ Name: local/run-tests │
│ Description: Run unit tests with coverage │
│ Source: custom │
│ Mode: required │
│ Config: ./validations/run-tests.yaml │
│ Created: 2026-02-09 10:15 │
╰────────────────────────────────────────────────────────╯
╭─ Capability ────────────────────────╮
│ Read-Only: true (enforced) │
│ Checkpointable: false (enforced) │
│ Timeout: 600s │
╰─────────────────────────────────────╯
✓ OK Validation registered
$ agents validation add --config ./validations/lint-check.yaml
╭─ Validation Registered ──────────────╮
│ Name: local/lint-check │
│ Description: Lint check │
│ Source: custom │
│ Mode: required │
│ Timeout: 300s │
╰──────────────────────────────────────╯
✓ OK Validation registered
$ agents validation add --config ./validations/check-bundle-size.yaml
╭─ Validation Registered ───────────────────────────╮
│ Name: local/check-bundle-size │
│ Description: Check bundle size (advisory) │
│ Source: custom │
│ Mode: informational │
│ Timeout: 300s │
╰───────────────────────────────────────────────────╯
✓ OK Validation registered
agents validation attach [--project <PROJECT>|--plan <PLAN_ID>]
<RESOURCE> <VALIDATION> [<ARGS>...]
$ agents validation attach --project local/api-service local/api-repo local/run-tests
╭─ Validation Attached ──────────────────────────────────────╮
│ Attachment ID: 01HXM5A1B2C3D4E5F6G7H8J9K0 │
│ Validation: local/run-tests │
│ Mode: required │
│ Resource: local/api-repo │
│ Scope: project local/api-service │
╰────────────────────────────────────────────────────────────╯
✓ OK Validation attached
$ agents validation attach local/api-repo local/lint-check
╭─ Validation Attached ──────────────────────────────────────╮
│ Attachment ID: 01HXM5B2C3D4E5F6G7H8J9K0L1 │
│ Validation: local/lint-check │
│ Mode: required │
│ Resource: local/api-repo │
│ Scope: direct (always active) │
│ This validation will run for ALL plans/projects │
│ that access this resource. │
╰────────────────────────────────────────────────────────────╯
✓ OK Validation attached
$ agents validation attach --project local/api-service local/api-repo local/run-tests --coverage-threshold 90
╭─ Validation Attached ──────────────────────────────────────╮
│ Attachment ID: 01HXM5C3D4E5F6G7H8J9K0L1M2 │
│ Validation: local/run-tests │
│ Mode: required │
│ Resource: local/api-repo │
│ Scope: project local/api-service │
│ Args: coverage_threshold=90 │
╰────────────────────────────────────────────────────────────╯
✓ OK Validation attached
agents validation detach [--yes|-y] <ATTACHMENT_ID>
$ agents validation detach 01HXM5A1B2C3D4E5F6G7H8J9K0
Detach validation local/run-tests from resource local/api-repo (scope: project local/api-service)? [y/N]: y
╭─ Validation Detached ───────────────────────────────────────╮
│ Attachment ID: 01HXM5A1B2C3D4E5F6G7H8J9K0 │
│ Validation: local/run-tests │
│ Resource: local/api-repo │
│ Scope: project local/api-service │
╰─────────────────────────────────────────────────────────────╯
✓ OK Validation detached
agents resource type add --config|-c <FILE> [--update]
$ agents resource type add --config ./resource-types/svn.yaml
╭─ Resource Type ────────────────────╮
│ Name: local/svn │
│ Physical/Virtual: physical │
│ User Addable: yes │
│ Registered: 2026-02-09 10:15 │
╰────────────────────────────────────╯
╭─ CLI Arguments ────────────────────────╮
│ Argument Required Description │
│ ──────────── ──────── ───────────── │
│ --url yes Repository URL │
│ --checkout no Local checkout │
╰────────────────────────────────────────╯
╭─ Child Types ──────────────────────────╮
│ Auto-discover: svn-revision, svn-file │
│ Manual link: fs-mount │
╰────────────────────────────────────────╯
╭─ Sandbox ──────────────────────╮
│ Strategy: copy_on_write │
│ Handler: SVNHandler (custom) │
╰────────────────────────────────╯
✓ OK Resource type registered
ℹ New subcommand available: agents resource add local/svn
agents resource type remove [--yes|-y] <NAME>
$ agents resource type remove local/svn
Remove resource type local/svn? [y/N]: y
╭─ Resource Type Removed ───────╮
│ Name: local/svn │
│ Resources Using: 0 │
│ Subcommand Removed: yes │
╰───────────────────────────────╯
✓ OK Resource type removed
agents resource type list [<REGEX>]
$ agents resource type list
╭─ Resource Types ──────────────────────────────────────────────────────────────────────────────────╮
│ Name Source Phys/Virt Addable Auto-children │
│ ─────────────────── ──────── ───────── ─────── ────────────────────────────────────── │
│ git-checkout built-in physical yes git, fs-directory │
│ git built-in physical yes git-remote, git-branch, git-tag, │
│ git-commit, git-stash, git-submodule │
│ git-remote built-in physical no (none) │
│ git-branch built-in physical no git-commit │
│ git-tag built-in physical no (none) │
│ git-commit built-in physical no git-tree │
│ git-tree built-in physical no git-tree-entry │
│ git-tree-entry built-in physical no (none) │
│ git-stash built-in physical no (none) │
│ git-submodule built-in physical no (none) │
│ fs-mount built-in physical yes fs-directory │
│ fs-directory built-in physical yes fs-file, fs-directory, │
│ fs-symlink, fs-hardlink │
│ fs-file built-in physical no (none) │
│ fs-symlink built-in physical no (none) │
│ fs-hardlink built-in physical no (none) │
│ file built-in virtual no (none) │
│ directory built-in virtual no (none) │
│ symlink built-in virtual no (none) │
│ commit built-in virtual no (none) │
│ branch built-in virtual no (none) │
│ tag built-in virtual no (none) │
│ remote built-in virtual no (none) │
│ submodule built-in virtual no (none) │
│ tree built-in virtual no (none) │
│ local/svn custom physical yes svn-revision, svn-file │
╰───────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Summary ─────────────────╮
│ Built-in: 24 │
│ Custom: 1 │
│ User Addable: 4 │
╰───────────────────────────╯
✓ OK 25 resource types listed
agents resource type show <NAME>
$ agents resource type show git-checkout
╭─ Resource Type ──────────────────────────────────────────────────────╮
│ Name: git-checkout │
│ Source: built-in │
│ Description: A locally checked-out git repository with worktree │
│ Physical/Virtual: physical │
│ User Addable: yes │
╰──────────────────────────────────────────────────────────────────────╯
╭─ CLI Arguments (agents resource add git-checkout) ─────────────────╮
│ Argument Required Type Description │
│ ────────── ──────── ────── ────────────────────────────── │
│ --path yes path Local checkout directory │
│ --branch no string Default branch (default: main) │
╰────────────────────────────────────────────────────────────────────╯
╭─ Parent Types ───────────────╮
│ Allowed: (any, top-level OK) │
╰──────────────────────────────╯
╭─ Child Types ────────────────────────────────────────────────────╮
│ Type Auto Manual Link Description │
│ ───────────── ──── ─────────── ────────────────────────── │
│ git yes no Repo object DB and history │
│ fs-directory yes no Worktree root directory │
╰──────────────────────────────────────────────────────────────────╯
╭─ Sandbox ──────────────────────╮
│ Strategy: git_worktree │
│ Checkpointable: yes │
│ Handler: GitCheckoutHandler │
╰────────────────────────────────╯
✓ OK Resource type details loaded
agents resource add [(--description|-d) <DESC>] [--update] <TYPE> <NAME> [type-specific-flags...]
$ agents resource add git-checkout local/api-repo --path /home/user/projects/api-service --branch main
╭─ Resource ──────────────────────────────────────╮
│ Name: local/api-repo │
│ ID: 01HXR1A1B2C3D4E5F6G7H8J9K0 │
│ Type: git-checkout │
│ Physical/Virtual: physical │
│ Path: /home/user/projects/api-service │
│ Branch: main │
│ Created: 2026-02-09 10:20 │
╰─────────────────────────────────────────────────╯
╭─ Auto-discovered Children ─────────────────────────────────────────╮
│ ID Type Status │
│ ─────────────── ────────────── ───────────────── │
│ 01HXR1A1B2C3… git created │
│ 01HXR1A1B2C4… git-remote created │
│ 01HXR1A1B2C5… git-branch created │
│ 01HXR1A1B2C6… git-branch created │
│ 01HXR1A1B2C7… fs-directory created │
│ + 47 git-commit resources │
│ + 312 git-tree-entry resources │
│ + 3 fs-directory + 28 fs-file │
╰────────────────────────────────────────────────────────────────────╯
╭─ Capabilities ─────────────────╮
│ Readable: yes │
│ Writable: yes │
│ Sandboxable: yes │
│ Checkpointable: yes │
│ Sandbox Strategy: git_worktree │
╰────────────────────────────────╯
✓ OK Resource registered (395 child resources discovered)
$ agents resource add fs-mount local/docs --mount-path /docs/api-reference
╭─ Resource ──────────────────────────────────────╮
│ Name: local/docs │
│ ID: 01HXR2B3C4D5E6F7G8H9J0K1L2 │
│ Type: fs-mount │
│ Physical/Virtual: physical │
│ Mount Path: /docs/api-reference │
│ Created: 2026-02-09 10:22 │
╰─────────────────────────────────────────────────╯
╭─ Auto-discovered Children ────────────────────╮
│ + 1 fs-directory (root) │
│ + 3 fs-directory resources │
│ + 28 fs-file resources │
╰───────────────────────────────────────────────╯
╭─ Capabilities ──────────────────────╮
│ Readable: yes │
│ Writable: yes │
│ Sandboxable: yes │
│ Checkpointable: yes │
│ Sandbox Strategy: copy_on_write │
╰─────────────────────────────────────╯
✓ OK Resource registered (31 child resources discovered)
$ agents resource add container-instance local/api-dev --mount local/api-repo:/workspace --mount /home/user/.config/nvim:/home/dev/.config/nvim
╭─ Resource ──────────────────────────────────────╮
│ Name: local/api-dev │
│ ID: 01HXR3C4D5E6F7G8H9J0K1L2M3 │
│ Type: container-instance │
│ Physical/Virtual: physical │
│ State: created (not started) │
│ Created: 2026-02-09 10:25 │
╰─────────────────────────────────────────────────╯
╭─ Mounts ──────────────────────────────────────────────────────────╮
│ Source Container Path Kind │
│ ──────────────────────────────── ─────────────── ─────────── │
│ local/api-repo /workspace resource-ref │
│ /home/user/.config/nvim /home/dev/… host-path │
╰───────────────────────────────────────────────────────────────────╯
✓ OK Container resource registered (container will start on first access)
$ agents resource add container-instance cloud/ci-runner --clone-into https://github.com/acme/api.git:/workspace
╭─ Resource ──────────────────────────────────────╮
│ Name: cloud/ci-runner │
│ ID: 01HXR4D5E6F7G8H9J0K1L2M3N4 │
│ Type: container-instance │
│ Physical/Virtual: physical │
│ State: created (not started) │
│ Clone: https://github.com/acme/api.git │
│ Clone Target: /workspace │
│ Created: 2026-02-09 10:27 │
╰─────────────────────────────────────────────────╯
✓ OK Container resource registered (repo will be cloned on first start)
$ agents resource add git-checkout local/webapp --path /home/user/projects/webapp
╭─ Resource ──────────────────────────────────────────╮
│ Name: local/webapp │
│ ID: 01HXR5E6F7G8H9J0K1L2M3N4O5 │
│ Type: git-checkout │
│ Physical/Virtual: physical │
│ Path: /home/user/projects/webapp │
│ Branch: main │
│ Created: 2026-02-09 10:30 │
╰─────────────────────────────────────────────────────╯
╭─ Auto-discovered Children ─────────────────────────────────────────╮
│ ID Type Status │
│ ─────────────── ────────────────────── ─────────────────── │
│ 01HXR5E6F7G9… git created │
│ 01HXR5E6F7GA… devcontainer-instance detected (not built) │
│ 01HXR5E6F7GB… fs-directory created │
│ + 52 git-commit resources │
│ + 189 git-tree-entry resources │
╰────────────────────────────────────────────────────────────────────╯
⚠ Devcontainer detected at .devcontainer/devcontainer.json
Container will be built lazily on first access.
Use agents resource show 01HXR5E6F7GA… to inspect.
✓ OK Resource registered (245 child resources discovered)
agents resource remove [--yes|-y] <NAME>
$ agents resource remove local/api-repo
Remove resource local/api-repo and 395 child resources? [y/N]: y
╭─ Resource Removed ──────────────────────────────────╮
│ Name: local/api-repo │
│ Type: git-checkout │
│ Children Removed: 395 │
│ Projects Unlinked: 0 │
╰─────────────────────────────────────────────────────╯
✓ OK Resource removed
agents resource list [--all] [(--type|-t) <TYPE>]
$ agents resource list
╭─ Resources ──────────────────────────────────────────────────────────────────────────────────────────────╮
│ Name ID Type Phys/Virt Children Projects │
│ ───────────────── ──────────────────────────── ─────────── ───────── ──────── ──────────────── │
│ local/api-repo 01HXR1A1B2C3D4E5F6G7H8J9K0 git-checkout physical 395 local/api-service │
│ local/docs 01HXR2B2C3D4E5F6G7H8J9K0L1 fs-mount physical 32 local/api-service │
│ local/staging-db 01HXR3C3D4E5F6G7H8J9K0L1M2 database physical 12 local/api-service, │
│ local/staging │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Summary ───────────╮
│ Total: 3 │
│ Physical: 3 │
│ Virtual: 0 │
│ Total Children: 405 │
╰─────────────────────╯
✓ OK 3 resources listed
agents resource show <RESOURCE>
$ agents resource show local/api-repo
╭─ Resource ─────────────────────────────────────────╮
│ Name: local/api-repo │
│ ID: 01HXR1A1B2C3D4E5F6G7H8J9K0 │
│ Type: git-checkout │
│ Physical/Virtual: physical │
│ Path: /home/user/projects/api-service │
│ Branch: main │
│ Created: 2026-02-09 10:20 │
╰────────────────────────────────────────────────────╯
╭─ Capabilities ────────────────────╮
│ Readable: yes │
│ Writable: yes │
│ Sandboxable: yes │
│ Checkpointable: yes │
│ Sandbox Strategy: git_worktree │
╰───────────────────────────────────╯
╭─ Parents ────╮
│ (top-level) │
╰──────────────╯
╭─ Direct Children ──────────────────────────────────────────────────────╮
│ ID Type Auto Children │
│ ──────────────────────────── ──────────── ──── ──────── │
│ 01HXR4D4E5F6G7H8J9K0L1M2N3 git yes 363 │
│ 01HXR5E5F6G7H8J9K0L1M2N3P4 fs-directory yes 32 │
╰────────────────────────────────────────────────────────────────────────╯
╭─ Linked Projects ─────────────╮
│ - local/api-service (r/w) │
╰───────────────────────────────╯
╭─ Tool Bindings ────────────────────────────────╮
│ Tool Slot Access │
│ ──────────────────────── ───── ─────────── │
│ (builtin) git_status repo read_only │
│ (builtin) git_diff repo read_only │
│ (builtin) git_log repo read_only │
│ local/run-migrations db (not bound) │
╰────────────────────────────────────────────────╯
✓ OK Resource details loaded
agents resource inspect [--tree] [--file <PATH>] <RESOURCE>
$ agents resource inspect local/api-repo --tree
╭─ Resource Tree: local/api-repo ──────────────────────────────────────╮
│ │
│ /home/user/projects/api-service │
│ ├── src/ │
│ │ ├── api/ │
│ │ │ ├── __init__.py │
│ │ │ ├── auth/ │
│ │ │ │ ├── auth_middleware.py │
│ │ │ │ ├── token_service.py │
│ │ │ │ └── rbac.py │
│ │ │ ├── routes/ │
│ │ │ └── models/ │
│ │ └── utils/ │
│ ├── tests/ │
│ ├── README.md │
│ └── pyproject.toml │
│ │
╰──────────────────────────────────────────────────────────────────────╯
╭─ Summary ──────────────╮
│ Directories: 8 │
│ Files: 41 │
│ Total Size: 284 KB │
╰────────────────────────╯
✓ OK Resource tree displayed
$ agents resource inspect local/api-repo --file src/api/auth/auth_middleware.py
╭─ File: src/api/auth/auth_middleware.py ──────────────────╮
│ Resource: local/api-repo │
│ Size: 2.4 KB │
│ Language: Python │
│ Last Modified: 2026-02-10 14:32 │
╰──────────────────────────────────────────────────────────╯
1 │ from fastapi import Request, HTTPException
2 │ from .token_service import validate_token
3 │
4 │ async def auth_middleware(request: Request):
5 │ token = request.headers.get("Authorization")
6 │ if not token:
7 │ raise HTTPException(status_code=401)
8 │ user = await validate_token(token)
9 │ request.state.user = user
10 │ return user
│ ... (24 more lines)
✓ OK File displayed
agents resource tree [(--depth|-d) <N>] [(--type|-t) <TYPE>] <RESOURCE>
$ agents resource tree local/api-repo --depth 2
╭─ Resource Tree: local/api-repo ─────────────────────────────────────╮
│ │
│ git-checkout 01HXR1A1..J9K0 (physical) │
│ ├── git 01HXR4D4..M2N3 (physical) │
│ │ ├── git-remote 01HXR6F6..P4Q5 │
│ │ ├── git-branch 01HXR7G7..Q5R6 │
│ │ │ ├── git-commit 01HXR8H8..R6S7 │
│ │ │ └── ... 22 more git-commit resources │
│ │ └── git-branch 01HXR9J9..S7T8 │
│ │ └── ... 26 git-commit resources │
│ └── fs-directory 01HXR5E5..N3P4 (physical) │
│ ├── fs-directory 01HXRAK1..T8U9 │
│ ├── fs-directory 01HXRBL2..U9V0 │
│ └── ... 28 more fs-file resources │
│ │
╰─────────────────────────────────────────────────────────────────────╯
╭─ Summary ──────────────╮
│ Total shown: 14 │
│ Total in subtree: 395 │
│ Max depth: 2 │
╰────────────────────────╯
✓ OK Resource tree displayed
agents resource link-child <PARENT> <CHILD>
$ agents resource link-child local/api-repo 01HXR2B2C3D4E5F6G7H8J9K0L1
╭─ Child Linked ──────────────────────────────────────╮
│ Parent: local/api-repo │
│ Child: 01HXR2B2C3D4E5F6G7H8J9K0L1 │
│ Child Type: fs-mount │
│ Status: linked │
╰─────────────────────────────────────────────────────╯
✓ OK Child resource linked
agents resource unlink-child [--yes|-y] <PARENT> <CHILD>
$ agents resource unlink-child local/api-repo 01HXR2B2C3D4E5F6G7H8J9K0L1
Unlink 01HXR2B2C3D4E5F6G7H8J9K0L1 from parent local/api-repo? [y/N]: y
╭─ Child Unlinked ────────────────────────────────────╮
│ Parent: local/api-repo │
│ Child: 01HXR2B2C3D4E5F6G7H8J9K0L1 │
│ Status: unlinked │
╰─────────────────────────────────────────────────────╯
✓ OK Child resource unlinked
agents resource stop <NAME> [--yes | -y]
$ agents resource stop local/my-dc
Stopping container local/my-dc (state: running)...
Stopped: local/my-dc
agents resource rebuild <NAME> [--yes | -y]
$ agents resource rebuild local/my-dc
Rebuilding local/my-dc...
Rebuilt: local/my-dc
agents plan list [--phase <PHASE>] [--state <STATE>] [--project <PROJECT>]
[--action <ACTION>] [<REGEX>]
$ agents --format table plan list --phase execute
╭─ Plans ──────────────────────────────────────────────────────────────────────────────╮
│ ID Phase State Action Project Elapsed │
│ ──────── ─────── ────────── ─────────────────── ───────────────── ───────── │
│ 01HXM7A9 execute processing local/code-coverage local/api-service 00:01:12 │
╰──────────────────────────────────────────────────────────────────────────────────────╯
╭─ Filters ──────╮
│ Phase: execute │
│ State: (any) │
│ Project: (any) │
│ Action: (any) │
╰────────────────╯
╭─ Summary ─────────╮
│ Total: 1 │
│ Processing: 1 │
│ Completed: 0 │
│ Errored: 0 │
╰───────────────────╯
✓ OK 1 plan listed
$ agents plan list
╭─ Plans ──────────────────────────────────────────────────────────────────────────────────────╮
│ ID Phase State Action Project Elapsed │
│ ──────── ────────── ────────── ─────────────────── ───────────────── ───────── │
│ 01HXM7A9 execute processing local/code-coverage local/api-service 00:01:12 │
│ 01HXM6R3 apply applied local/add-auth local/api-service 00:07:14 │
│ 01HXM5K2 execute errored local/migrate-db local/api-service 00:04:33 │
│ 01HXM4J1 strategize processing local/refactor-api local/web-app 00:00:45 │
│ 01HXM3H8 cancelled cancelled local/add-logging local/api-service 00:02:10 │
╰──────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Summary ─────────────╮
│ Total: 5 │
│ Processing: 2 │
│ Completed: 1 │
│ Errored: 1 │
│ Cancelled: 1 │
╰───────────────────────╯
✓ OK 5 plans listed
$ agents plan list --project local/web-app
╭─ Plans ──────────────────────────────────────────────────────────────────────────────╮
│ ID Phase State Action Project Elapsed │
│ ──────── ────────── ────────── ─────────────────── ───────────── ───────── │
│ 01HXM4J1 strategize processing local/refactor-api local/web-app 00:00:45 │
╰──────────────────────────────────────────────────────────────────────────────────────╯
╭─ Filters ─────────────────╮
│ Phase: (any) │
│ State: (any) │
│ Project: local/web-app │
│ Action: (any) │
╰───────────────────────────╯
✓ OK 1 plan listed
agents plan use [--automation-profile <PROFILE>]
[--invariant <INVARIANT>]...
[--strategy-actor <STRATEGY_ACTOR>]
[--execution-actor <EXEC_ACTOR>]
[--estimation-actor <EST_ACTOR>]
[--invariant-actor <INV_ACTOR>]
[--execution-environment <RESOURCE_NAME>]
[--execution-env-priority (fallback|override)]
[--arg/-a name=value]...
<ACTION> <PROJECT>...
$ agents plan use local/code-coverage local/api-service \
--arg target_coverage_percent=85 --automation-profile trusted
╭─ Plan Created ──────────────────────╮
│ Plan ID: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Phase: strategize │
│ Action: local/code-coverage │
│ Project: local/api-service │
│ Automation: trusted │
│ Attempt: 1 │
╰─────────────────────────────────────╯
╭─ Inputs ──────────────────────╮
│ - target_coverage_percent=85 │
│ - automation_profile=trusted │
╰───────────────────────────────╯
╭─ Actors ────────────────────────╮
│ Strategy: local/strategist │
│ Execution: local/executor │
│ Estimation: (none) │
╰─────────────────────────────────╯
╭─ Automation ─────────────────────────╮
│ Profile: trusted │
│ Source: CLI flag │
│ Read-Only: no │
╰──────────────────────────────────────╯
╭─ Context ───────────────────────╮
│ Resources: 2 (repo, db) │
│ Indexed Files: 347 │
│ View: strategize │
│ Hot Token Budget: 12,000 │
╰─────────────────────────────────╯
╭─ Next Steps ─────────────────────────────────────╮
│ - agents plan execute 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ - agents plan status 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ - agents plan tree 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
╰──────────────────────────────────────────────────╯
✓ OK Plan created
$ agents plan use local/security-audit local/api-service local/web-app \
--invariant "Never modify production database schemas" \
--invariant "All changes must include test coverage" \
--automation-profile supervised
╭─ Plan Created ──────────────────────────────────────╮
│ Plan: 01HXM9D2ZK4Q7C2B3F2R4VYV6J │
│ Action: local/security-audit │
│ Phase: strategize (running) │
│ Automation: supervised │
╰─────────────────────────────────────────────────────╯
╭─ Target Projects ───────────────────╮
│ 1. local/api-service (3 resources) │
│ 2. local/web-app (2 resources) │
╰─────────────────────────────────────╯
╭─ Plan Invariants ──────────────────────────────────────────╮
│ Scope Source Invariant │
│ ──────── ─────── ────────────────────────────────── │
│ plan CLI Never modify production DB schemas │
│ plan CLI All changes must include test coverage │
│ project config API responses must be backward-compat │
│ global config Follow Python PEP 8 style guide │
╰────────────────────────────────────────────────────────────╯
✓ OK Plan created — strategize in progress
$ agents plan use local/code-coverage local/api-service \
--strategy-actor local/senior-planner \
--execution-actor local/fast-executor \
--arg target_coverage_percent=95
╭─ Plan Created ──────────────────────────────────────╮
│ Plan: 01HXM9E3ZK4Q7C2B3F2R4VYV6J │
│ Action: local/code-coverage │
│ Phase: strategize (running) │
│ Automation: trusted │
╰─────────────────────────────────────────────────────╯
╭─ Actor Overrides ────────────────────╮
│ Strategy: local/senior-planner │
│ Execution: local/fast-executor │
│ (Estimation: action default) │
╰──────────────────────────────────────╯
╭─ Arguments ─────────────────╮
│ target_coverage_percent: 95 │
╰─────────────────────────────╯
✓ OK Plan created — strategize in progress
agents plan execute <PLAN_ID>
$ agents plan execute 01HXM8C2ZK4Q7C2B3F2R4VYV6J
╭─ Execution ──────────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Phase: execute │
│ Sandbox: git_worktree │
│ Worker: local/executor │
│ Started: 12:58:10 │
│ Attempt: 1 │
╰──────────────────────────────────╯
╭─ Sandbox ──────────────────────────────────╮
│ Strategy: git_worktree │
│ Path: /repos/api/.worktrees/plan-01HXM8 │
│ Branch: cleveragents/plan-01HXM8C2 │
│ Status: active │
╰────────────────────────────────────────────╯
╭─ Strategy Summary ─────────────────────╮
│ Decisions: 8 │
│ Invariants: 2 │
│ Planned Child Plans: 2+ │
│ Estimated Files: ~12 │
│ Risk: low │
╰────────────────────────────────────────╯
╭─ Progress ─────────╮
│ ⏳ Collect context │
│ • Run tools │
│ • Build changeset │
│ • Validate │
╰────────────────────╯
✓ OK Execution started
$ agents plan execute 01HXM7K2ZK4Q7C2B3F2R4VYV6J
╭─ Execution Resumed ─────────────────╮
│ Plan: 01HXM7K2ZK4Q7C2B3F2R4VYV6J │
│ Phase: execute (resumed) │
│ Sandbox: git_worktree │
│ Worker: local/executor │
│ Checkpoint: cp_01HXM8C2 (loaded) │
│ Resumed From: step 4 of 6 │
╰─────────────────────────────────────╯
╭─ Previous Progress ──────────────────────╮
│ ✓ Step 1: Collect context (0.8s) │
│ ✓ Step 2: Analyze codebase (4.2s) │
│ ✓ Step 3: Generate migrations (6.1s) │
│ ✗ Step 4: Apply migrations (errored) │
│ ○ Step 5: Update models (pending) │
│ ○ Step 6: Run validations (pending) │
╰──────────────────────────────────────────╯
╭─ Guidance Applied ──────────────────────────────────────────────╮
│ "Use smaller batch sizes for the migration to avoid timeouts" │
╰─────────────────────────────────────────────────────────────────╯
✓ OK Execution resumed from checkpoint cp_01HXM8C2
agents plan apply [--yes|-y] <PLAN_ID>
$ agents plan apply 01HXM8C2ZK4Q7C2B3F2R4VYV6J
Apply changes for plan 01HXM8C2ZK4Q7C2B3F2R4VYV6J? [y/N]: y
╭─ Apply Summary ─────────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Artifacts: 6 files updated │
│ Changes: 42 insertions, 9 deletions │
│ Project: local/api-service │
│ Applied At: 2026-02-08 13:04 │
╰─────────────────────────────────────╯
╭─ Validation (from Execute) ────╮
│ Tests: passed (24/24) │
│ Lint: passed (0 warnings) │
│ Type Check: passed (0 errors) │
│ Duration: 12.4s │
╰────────────────────────────────╯
╭─ Sandbox Cleanup ─────────╮
│ Worktree: removed │
│ Branch: merged to main │
│ Checkpoint: archived │
╰───────────────────────────╯
╭─ Plan Lifecycle ────────────────────────╮
│ Phase: apply │
│ State: applied │
│ Total Duration: 00:06:14 │
│ Total Cost: $0.0847 │
│ Decisions Made: 8 │
│ Child Plans: 2 (completed) │
╰─────────────────────────────────────────╯
╭─ Next Steps ──────╮
│ - Review git diff │
│ - Commit changes │
╰───────────────────╯
✓ OK Changes applied
$ agents plan apply --yes 01HXM8C2ZK4Q7C2B3F2R4VYV6J
╭─ Apply Summary ─────────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Artifacts: 6 files updated │
│ Changes: 42 insertions, 9 deletions │
│ Project: local/api-service │
╰─────────────────────────────────────╯
╭─ Validation ───────────────────────────────────────────────╮
│ ✗ Tests: FAILED (22/24 passed, 2 failed) │
│ FAIL test_auth.py::test_session_refresh — AssertionError │
│ FAIL test_auth.py::test_token_expiry — TimeoutError │
│ ✓ Lint: passed (0 warnings) │
│ ✓ Type Check: passed (0 errors) │
│ Duration: 14.8s │
╰────────────────────────────────────────────────────────────╯
╭─ Sandbox Status ─────────────────────────────────────────────╮
│ Worktree: preserved (changes NOT committed) │
│ Checkpoint: cp_01HXM8C2 (pre-apply state available) │
│ The sandbox is preserved for correction or manual review. │
╰──────────────────────────────────────────────────────────────╯
╭─ Recovery Options ──────────────────────────────────────────────────╮
│ - agents plan prompt — provide guidance to fix test failures │
│ - agents plan correct — revert and re-execute with guidance │
│ - agents plan rollback — restore to a previous checkpoint │
│ - agents plan cancel — abort the plan entirely │
╰─────────────────────────────────────────────────────────────────────╯
✗ ERROR Apply refused — 2 required Execute-phase validations did not pass
agents plan status <PLAN_ID>
$ agents plan status 01HXM8C2ZK4Q7C2B3F2R4VYV6J
╭─ Plan Status ────────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Phase: execute │
│ State: processing │
│ Action: local/code-coverage │
│ Project: local/api-service │
│ Automation: review │
│ Attempt: 1 │
╰──────────────────────────────────╯
╭─ Progress ───────╮
│ ✓ Strategize │
│ ⏳ Execute │
│ • Apply (queued) │
╰──────────────────╯
╭─ Timing ──────────╮
│ Started: 12:57:01 │
│ Elapsed: 00:01:12 │
│ ETA: 00:03:45 │
╰───────────────────╯
╭─ Execution Detail ──────────╮
│ Sandbox: git_worktree │
│ Tool Calls: 8 │
│ Files Modified: 3 │
│ Child Plans: 1/2 complete │
│ Checkpoints: 2 created │
╰─────────────────────────────╯
╭─ Cost ───────────────╮
│ Tokens Used: 12,420 │
│ Cost So Far: $0.041 │
│ Estimated: $0.085 │
╰──────────────────────╯
✓ OK Status refreshed
$ agents plan status 01HXM6R3ZK4Q7C2B3F2R4VYV6J
╭─ Plan Status ─────────────────────╮
│ Plan: 01HXM6R3ZK4Q7C2B3F2R4VYV6J │
│ Phase: apply │
│ State: applied │
│ Action: local/add-auth │
│ Project: local/api-service │
│ Automation: trusted │
│ Attempt: 1 │
╰───────────────────────────────────╯
╭─ Progress ───────────╮
│ ✓ Strategize │
│ ✓ Execute │
│ ✓ Apply (committed) │
╰──────────────────────╯
╭─ Timing ─────────────────────────╮
│ Started: 2026-02-08 12:57:01 │
│ Finished: 2026-02-08 13:04:15 │
│ Total Duration: 00:07:14 │
╰──────────────────────────────────╯
╭─ Result ────────────────────────────╮
│ Decisions Made: 8 │
│ Child Plans: 2/2 complete │
│ Artifacts: 6 files updated │
│ Validations: 3/3 passed │
│ Total Cost: $0.085 │
╰─────────────────────────────────────╯
✓ OK Plan completed successfully
$ agents plan status 01HXM9F2ZK4Q7C2B3F2R4VYV6J
╭─ Plan Status ────────────────────╮
│ Plan: 01HXM9F2ZK4Q7C2B3F2R4VYV6J │
│ Phase: strategize │
│ State: processing │
│ Action: local/refactor-auth │
│ Project: local/api-service │
│ Automation: supervised │
╰──────────────────────────────────╯
╭─ Progress ───────────────╮
│ ⏳ Strategize (running) │
│ ○ Execute (waiting) │
│ ○ Apply (waiting) │
╰──────────────────────────╯
╭─ Strategy Progress ────────╮
│ Decisions Made: 4 │
│ Invariants Enforced: 2 │
│ Child Plans Planned: 3 │
│ Elapsed: 00:00:28 │
╰────────────────────────────╯
✓ OK Strategize in progress
$ agents plan status 01HXM7K2ZK4Q7C2B3F2R4VYV6J
╭─ Plan Status ────────────────────╮
│ Plan: 01HXM7K2ZK4Q7C2B3F2R4VYV6J │
│ Phase: execute │
│ State: errored │
│ Action: local/migrate-db │
│ Project: local/api-service │
│ Automation: supervised │
│ Attempt: 1 │
╰──────────────────────────────────╯
╭─ Progress ───────────╮
│ ✓ Strategize │
│ ✗ Execute │
│ ○ Apply (skipped) │
╰──────────────────────╯
╭─ Error Detail ──────────────────────────────────────────────────╮
│ Error: Tool invocation failed: connection refused │
│ Tool: local/db-migrate │
│ Step: 4 of 6 │
│ Checkpoint: cp_01HXM8C2 (sandbox state preserved) │
│ Recoverable: yes — use "agents plan prompt" to provide guidance │
╰─────────────────────────────────────────────────────────────────╯
╭─ Cost ───────────────╮
│ Tokens Used: 8,340 │
│ Cost So Far: $0.028 │
╰──────────────────────╯
✗ ERROR Plan errored — use `agents plan prompt` to resume or `agents plan cancel` to abort
agents plan cancel [(--reason|-r) <REASON>] <PLAN_ID>
$ agents plan cancel 01HXM8C2ZK4Q7C2B3F2R4VYV6J --reason "blocked on credentials"
╭─ Plan Cancelled ─────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Phase: execute │
│ Reason: blocked on credentials │
│ State: cancelled │
│ Cancelled At: 13:02:15 │
╰──────────────────────────────────╯
╭─ Sandbox ────────────────╮
│ Status: preserved │
│ Files Modified: 3 │
│ Checkpoints: 2 │
╰──────────────────────────╯
╭─ Child Plans ─────────────╮
│ Completed: 1 │
│ Cancelled: 1 │
│ Artifacts Preserved: yes │
╰───────────────────────────╯
╭─ Recovery ───────────────────────────────────────────╮
│ - Resolve credentials │
│ - Run agents plan execute 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
╰──────────────────────────────────────────────────────╯
✓ OK Plan cancelled
agents plan tree [--show-superseded] <PLAN_ID>
$ agents plan tree 01HXM8C2ZK4Q7C2B3F2R4VYV6J
╭─ Decision Tree ──────────────────────────────────────────────────────────────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ ├─ [prompt_definition] "Increase test coverage to 85%" │
│ ├─ [invariant_enforced] "Prioritize financial transaction and user mgmt code" │
│ ├─ [invariant_enforced] "All API calls over TCP must be mocked" │
│ ├─ [strategy_choice] "Prioritize auth and payments" (confidence: 0.82) │
│ ├─ [subplan_parallel_spawn] "Implement auth and payment modules, in parallel" │
│ │ ├─ [subplan_spawn] "Write auth tests" → Plan: 01HXM9F1A │
│ │ └─ [subplan_spawn] "Write payment tests" → Plan: 01HXM9F2B │
│ └─ [subplan_parallel_spawn] "Write tests for remaining modules" │
│ └─ ... │
╰──────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Tree Summary ─────────────╮
│ Nodes: 9 │
│ Depth: 3 │
│ Child Plans: 2+ │
│ Invariants: 2 │
│ Superseded: 0 (hidden) │
╰────────────────────────────╯
╭─ Child Plans ──────────────────────────────────────╮
│ ID Phase State │
│ ────────── ─────── ───────── │
│ 01HXM9F1A execute processing │
│ 01HXM9F2B execute queued │
╰────────────────────────────────────────────────────╯
╭─ Decision IDs (for correction) ──────────────────╮
│ Root: 01HXM9A0B1Q2W3R5G8Z0P4Q1X8 │
│ Invariant 1: 01HXM9A0C1R3X4S6G9Z1P5Q2Y9 │
│ Invariant 2: 01HXM9A0D2S4Y5T7H0Z2P6Q3Z0 │
│ Strategy: 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 │
│ Parallel 1: 01HXM9A1D3R8X5S7H1Z2P5Q2Y0 │
│ Spawn Auth: 01HXM9A2D3Q8W4R6H9Z1P5Q2X0 │
│ Spawn Payment: 01HXM9A3E4Q9W5R7I0Z2P6Q3X1 │
│ Parallel 2: 01HXM9A4F5Q0W6R8J1Z3P7Q4X2 │
╰──────────────────────────────────────────────────╯
✓ OK Decision tree rendered
agents plan explain [--show-context] [--show-reasoning] <DECISION_ID>
$ agents plan explain 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 --show-context
╭─ Decision ─────────────────────────────────────╮
│ ID: 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 │
│ Type: strategy_choice │
│ Question: Which modules should be prioritized? │
│ Chosen: Auth and payments │
│ Confidence: 0.82 │
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Sequence: 2 of 5 │
│ Created: 2026-02-08 12:58 │
╰────────────────────────────────────────────────╯
╭─ Alternatives Considered ──────────────────────╮
│ 1. Auth and payments (chosen) │
│ 2. User module first (coverage 71%, med risk) │
│ 3. All modules equally (spread thin) │
╰────────────────────────────────────────────────╯
╭─ Impact ──────────────────────╮
│ Downstream Decisions: 3 │
│ Downstream Child Plans: 2 │
│ Artifacts Produced: 5 │
│ Correction Impact: medium │
╰───────────────────────────────╯
╭─ Context Snapshot ───────────────╮
│ - Coverage < 70% in auth │
│ - Payments failures last release │
│ - Auth: 12 files, 45% coverage │
│ - Payments: 8 files, 52% cover. │
│ Hot Context Hash: sha256:4b2e... │
╰──────────────────────────────────╯
╭─ Rationale ───────────────────────────────────────╮
│ Auth and payment modules have the lowest coverage │
│ and highest business risk. Auth handles security │
│ tokens, payments handles money. Both had bugs in │
│ the last release traceable to missing tests. │
╰───────────────────────────────────────────────────╯
╭─ Correction ──────────────────────────────────────────────╮
│ agents plan correct 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 │
│ --mode revert --guidance "Prioritize payments first..." │
╰───────────────────────────────────────────────────────────╯
✓ OK Decision explained
$ agents plan explain --show-reasoning 01HXM9A1C2Q7W3R5G8Z0P4Q1X9
╭─ Decision ──────────────────────────────╮
│ ID: 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 │
│ Type: strategy_choice │
│ Choice: Convert to async/await │
│ Alternatives: 3 │
╰─────────────────────────────────────────╯
╭─ Alternatives Considered ────────────────────────────────────╮
│ 1. Convert to async/await patterns (chosen) │
│ 2. Keep synchronous with thread pool │
│ 3. Use callback-based approach │
╰──────────────────────────────────────────────────────────────╯
╭─ Rationale ──────────────────────────────────────────────────╮
│ Async/await is the modern Python standard for I/O-bound │
│ operations. The project already uses asyncio in 3 modules. │
│ Thread pools would add complexity without native support. │
╰──────────────────────────────────────────────────────────────╯
╭─ Model Reasoning (raw) ───────────────────────────────────────╮
│ I need to decide on the concurrency pattern for the payment │
│ processing module. Let me analyze the current codebase: │
│ │
│ 1. src/payments/api.py uses synchronous requests. │
│ 2. src/core/scheduler.py already uses asyncio. │
│ 3. The database driver (asyncpg) supports async natively. │
│ 4. Project invariant says "prefer modern Python patterns". │
│ │
│ Given that 3/5 core modules already use asyncio, and the │
│ database driver supports it, converting to async/await is │
│ the most consistent choice. Thread pools would work but │
│ add unnecessary complexity and don't integrate well with │
│ the existing asyncio event loop in scheduler.py. │
╰───────────────────────────────────────────────────────────────╯
✓ OK Decision explained
agents plan correct --mode (revert|append) (--guidance|-g) <GUIDANCE>
[--dry-run] [--yes|-y] <DECISION_ID>
$ agents plan correct 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 --mode revert \
--guidance "Prioritize payments first" --yes
╭─ Correction ────────────────────────────────────────╮
│ Mode: revert │
│ Impact: 3 decisions, 2 child plans, 5 artifacts │
│ New Decision: 01HXM9B7Z3Q1Q8K2E9H7K3W2M8 │
│ Corrects: 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 │
│ Attempt: 2 │
╰─────────────────────────────────────────────────────╯
╭─ Affected Subtree ──────────────╮
│ Decisions Invalidated: 3 │
│ Child Plans Rolled Back: 2 │
│ Artifacts Archived: 5 │
│ Unaffected Decisions: 2 │
╰─────────────────────────────────╯
╭─ Sandbox Rollback ─────────────╮
│ Checkpoint: cp_01HXM8C2 │
│ Files Reverted: 5 │
│ Status: restored │
╰────────────────────────────────╯
╭─ Recompute ──────────────╮
│ Queued: 2 child plans │
│ ETA: 4m │
╰──────────────────────────╯
╭─ History ───────────────────────────────────────────╮
│ - Original decision superseded │
│ - Prior artifacts archived for comparison │
│ - agents plan diff --correction 01HXM9B7Z3Q1Q8K2.. │
╰─────────────────────────────────────────────────────╯
✓ OK Correction applied
$ agents plan correct 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 --mode append \
--guidance "Also add rate limiting to the auth endpoints"
╭─ Correction ─────────────────────────────────────╮
│ Mode: append │
│ Impact: adds to existing subtree, no rollback │
│ New Decision: 01HXM9C3Z5T2Q8K2E9H7K3W2M8 │
│ Appended After: 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 │
│ Attempt: 2 │
╰──────────────────────────────────────────────────╯
╭─ Append Detail ─────────────────────────────────────────────────╮
│ Original decision preserved: yes │
│ Existing artifacts kept: yes │
│ Additional work: appended as new child plan │
│ The original 5 artifacts remain; a new child plan will add │
│ rate-limiting code on top of the existing auth changes. │
╰─────────────────────────────────────────────────────────────────╯
╭─ Queued ──────────╮
│ New child: 1 │
│ ETA: 2m │
╰───────────────────╯
✓ OK Append correction queued
$ agents plan correct 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 --mode revert \
--guidance "Use async/await pattern instead" --dry-run
╭─ Dry Run — Correction Preview ─────────────────────────────────────╮
│ ⚠ This is a preview only. No changes will be made. │
╰────────────────────────────────────────────────────────────────────╯
╭─ Would Revert ───────────────────────────────────────╮
│ Decisions to invalidate: 3 │
│ 01HXM9A1.. strategy_choice "sync pattern" │
│ 01HXM9A2.. implementation_choice "requests" │
│ 01HXM9A3.. tool_invocation write_file ×4 │
│ Child plans to roll back: 2 │
│ Artifacts to archive: 5 files │
│ Unaffected decisions: 2 (will be kept) │
╰──────────────────────────────────────────────────────╯
╭─ Estimated Cost ──────────╮
│ Re-strategize: ~$0.012 │
│ Re-execute: ~$0.035 │
│ Total: ~$0.047 │
│ ETA: ~4 minutes │
╰───────────────────────────╯
To execute this correction, remove --dry-run and add --yes
agents plan diff (--correction <CORRECTION_ATTEMPT_ID>|<PLAN_ID>)
$ agents plan diff 01HXM8C2ZK4Q7C2B3F2R4VYV6J
╭─ Diff Summary ─────────────────────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Project: local/api-service │
│ Files Changed: 2 │
│ Insertions: 12 │
│ Deletions: 4 │
│ Net Change: +8 lines │
╰────────────────────────────────────────────────╯
╭─ Files ───────────────────────────────╮
│ Path Change Status │
│ ─────────────────── ────── ──────── │
│ src/auth/session.py +8 -2 modified │
│ src/auth/tokens.py +4 -2 modified │
╰───────────────────────────────────────╯
╭─ Patch Preview ──────────────────────────╮
│ --- a/src/auth/session.py │
│ +++ b/src/auth/session.py │
│ @@ -12,4 +12,10 @@ │
│ - import jwt │
│ + import sessionlib │
│ - def validate_token(...) │
│ + def validate_session(...) │
│ --- a/src/auth/tokens.py │
│ +++ b/src/auth/tokens.py │
│ @@ -5,3 +5,7 @@ │
│ - TOKEN_EXPIRY = 3600 │
│ + TOKEN_EXPIRY = 7200 │
╰──────────────────────────────────────────╯
╭─ Risk Assessment ────────────────╮
│ API Compatibility: preserved │
│ Test Coverage: maintained │
│ Breaking Changes: none detected │
╰──────────────────────────────────╯
✓ OK Diff generated
$ agents plan diff --correction 01HXM9B7Z3Q1Q8K2E9H7K3W2M8
╭─ Correction Diff ───────────────────────────────╮
│ Correction: 01HXM9B7Z3Q1Q8K2E9H7K3W2M8 │
│ Original Decision: 01HXM9A1C2Q7W3R5.. │
│ Mode: revert │
│ Files Changed: 3 │
│ New Insertions: 18 │
│ New Deletions: 6 │
╰─────────────────────────────────────────────────╯
╭─ Comparison ─────────────────────────────────────────────────────╮
│ File Before (original) After (corrected) │
│ ──────────────────── ──────────────── ──────────────────── │
│ src/payments/api.py +12 -4 +18 -6 (expanded) │
│ src/auth/tokens.py +8 -2 (unchanged) │
│ tests/test_payments.py (new file) (new file, larger) │
╰──────────────────────────────────────────────────────────────────╯
╭─ Patch Preview (corrected vs original) ───────────╮
│ --- a/src/payments/api.py (original) │
│ +++ b/src/payments/api.py (corrected) │
│ @@ -1,12 +1,18 @@ │
│ - # sync payment processing │
│ + # async payment processing (corrected) │
│ + import asyncio │
│ + from aiohttp import ClientSession │
│ ... │
╰───────────────────────────────────────────────────╯
✓ OK Correction diff generated
agents plan artifacts <PLAN_ID>
$ agents plan artifacts 01HXM8C2ZK4Q7C2B3F2R4VYV6J
╭─ Artifacts ─────────────────────────────────────────────────╮
│ Path Type Size Change Child Plan │
│ ───────────────────── ───── ────── ───────── ─────── │
│ src/auth/session.py write 2.1 KB +8 -2 root │
│ tests/test_session.py write 4.7 KB +47 -0 root │
│ src/auth/tokens.py edit 1.8 KB +4 -2 root │
│ tests/test_tokens.py write 3.2 KB +32 -0 auth │
╰─────────────────────────────────────────────────────────────╯
╭─ Summary ───────────╮
│ Total: 4 │
│ Writes: 2 (new) │
│ Edits: 2 (modified) │
│ Deletes: 0 │
│ Total Size: 11.8 KB │
╰─────────────────────╯
╭─ By Plan ─────────────────╮
│ Root Plan: 3 artifacts │
│ auth-tests: 1 artifact │
│ payment-tests: (pending) │
╰───────────────────────────╯
✓ OK 4 artifacts listed
agents plan prompt <PLAN_ID> <GUIDANCE>
$ agents plan prompt 01HXM8C2ZK4Q7C2B3F2R4VYV6J "Use mocks for database tests"
╭─ Guidance Added ────────────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Guidance: Use mocks for database tests │
│ Scope: next execution step │
│ Phase: execute │
│ State: errored → processing │
╰─────────────────────────────────────────╯
╭─ Decision Created ────────────────────────╮
│ Type: user_intervention │
│ ID: 01HXM9C5G7R2X8S3K4Z5Q8R6Y3 │
│ Parent: 01HXM9A1C2Q7W3R5G8Z0P4Q1X9 │
╰───────────────────────────────────────────╯
╭─ Queue ────╮
│ Pending: 1 │
│ Applied: 0 │
╰────────────╯
✓ OK Guidance queued
agents plan rollback [--yes|-y] <PLAN_ID> <CHECKPOINT_ID>
$ agents plan rollback 01HXM8C2ZK4Q7C2B3F2R4VYV6J cp_01HXM8C2
Rollback plan 01HXM8C2ZK4Q7C2B3F2R4VYV6J to cp_01HXM8C2? [y/N]: y
╭─ Rollback Summary ───────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Checkpoint: cp_01HXM8C2 │
│ Label: before auth refactor │
│ Files: 6 reverted │
╰──────────────────────────────────╯
╭─ Changes Reverted ──────────────────╮
│ File Action │
│ ────────────────────── ────────── │
│ src/auth/session.py restored │
│ src/auth/tokens.py restored │
│ tests/test_session.py removed │
│ tests/test_tokens.py removed │
│ src/auth/fixtures.py restored │
│ src/auth/__init__.py restored │
╰─────────────────────────────────────╯
╭─ Impact ──────────────────────────────╮
│ Child Plans Invalidated: 2 │
│ Sandbox: restored to cp_01HXM8C2 │
│ Decisions After CP: 2 discarded │
│ Tool Calls After CP: 5 undone │
╰───────────────────────────────────────╯
╭─ Post-Rollback State ──────────╮
│ Phase: execute │
│ State: queued (awaiting input) │
│ Checkpoints Remaining: 2 │
╰────────────────────────────────╯
✓ OK Rollback complete
agents action create --config|-c <CFG_FILE>
$ agents action create --config ./actions/code-coverage.yaml
╭─ Action Created ────────────────────────╮
│ Name: local/code-coverage │
│ State: available │
│ Strategy Actor: local/strategist │
│ Execution Actor: local/executor │
│ Reusable: yes │
│ Read Only: no │
│ Config: ./actions/code-coverage.yaml │
│ Created: 2026-02-08 12:20 │
╰─────────────────────────────────────────╯
╭─ Definition of Done ─╮
│ Coverage reaches 85% │
╰──────────────────────╯
╭─ Arguments ──────────────────────────────────────────────────────╮
│ Name Type Required Description │
│ ─────────────────────── ────── ──────── ───────────────────── │
│ target_coverage_percent int yes Target coverage % │
│ test_command string no Test framework to use │
╰──────────────────────────────────────────────────────────────────╯
╭─ Automation ──────────────────────────╮
│ Profile: supervised │
│ Source: default │
╰───────────────────────────────────────╯
✓ OK Action created
agents action list [(--namespace|-n) <NS>] [(--state|-s) <STATE>] [<REGEX>]
$ agents action list
╭─ Actions ──────────────────────────────────────────────────────────────────────────────────╮
│ Name State Strategy Actor Execution Actor Reusable Plans │
│ ─────────────────── ───────── ──────────────── ─────────────── ──────── ───── │
│ local/code-coverage available local/strategist local/executor ✓ 3 │
╰────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Filters ────────╮
│ State: available │
│ Namespace: (any) │
╰──────────────────╯
╭─ Summary ──────────────╮
│ Total: 1 │
│ Available: 1 │
│ Archived: 0 │
│ Total Plans Created: 3 │
╰────────────────────────╯
✓ OK 1 action listed
agents action show <ACTION_NAME>
$ agents action show local/code-coverage
╭─ Action Details ──────────────────────╮
│ Name: local/code-coverage │
│ State: available │
│ Strategy Actor: local/strategist │
│ Execution Actor: local/executor │
│ Reusable: yes │
│ Read Only: no │
│ Created: 2026-02-08 12:20 │
╰───────────────────────────────────────╯
╭─ Definition of Done ─╮
│ Coverage reaches 85% │
╰──────────────────────╯
╭─ Arguments ──────────────────────────────────────────────────────╮
│ Name Type Required Description │
│ ─────────────────────── ────── ──────── ───────────────────── │
│ target_coverage_percent int yes Target coverage % │
│ test_command string no Test framework to use │
╰──────────────────────────────────────────────────────────────────╯
╭─ Automation ──────────────────────────╮
│ Profile: supervised │
│ Source: default │
╰───────────────────────────────────────╯
╭─ History ────────────────────╮
│ Plans Created: 3 │
│ Plans Completed: 2 │
│ Plans Failed: 0 │
│ Avg Duration: 00:04:30 │
│ Avg Cost: $0.072 │
╰──────────────────────────────╯
╭─ Usage ───────────────────────────────────────────────────────────╮
│ - agents plan use local/code-coverage local/api-service │
│ --arg target_coverage_percent=85 │
╰───────────────────────────────────────────────────────────────────╯
✓ OK Action loaded
agents action archive <ACTION_NAME>
$ agents action archive local/old-action
╭─ Action Archived ───────────╮
│ Name: local/old-action │
│ State: available → archived │
│ Archived: 2026-02-08 12:22 │
╰─────────────────────────────╯
╭─ Impact ───────────────────────╮
│ Availability: hidden from list │
│ Existing Plans: unchanged │
│ Active Plans: 0 affected │
╰────────────────────────────────╯
╭─ History ─────────────────╮
│ Total Plans: 5 │
│ Completed: 4 │
│ Failed: 1 │
│ Last Used: 2026-02-06 │
╰───────────────────────────╯
✓ OK Action archived
agents automation-profile add --config|-c <FILE> [--update]
$ agents automation-profile add --config ./profiles/careful-auto.yaml
╭─ Profile Registered ─────────────────────────────────────────────╮
│ Name: local/careful-auto │
│ Description: Autonomous execution with mandatory sandbox │
│ and manual apply │
│ Created: 2026-02-08 14:30 │
╰──────────────────────────────────────────────────────────────────╯
╭─ Confidence Thresholds ────────────────╮
│ decompose_task: 0.0 │
│ create_tool: 0.0 │
│ select_tool: 1.0 │
│ edit_code: 0.0 │
│ execute_command: 0.0 │
│ create_file: 0.0 │
│ delete_content: 1.0 │
│ access_network: 1.0 │
│ install_dependency: 0.0 │
│ modify_config: 0.0 │
│ approve_plan: 0.0 │
│ require_sandbox: true │
│ require_checkpoints: true │
│ allow_unsafe_tools: false │
╰────────────────────────────────────────╯
✓ OK Profile registered
agents automation-profile remove [--yes|-y] <NAME>
$ agents automation-profile remove local/careful-auto
Remove automation profile local/careful-auto? [y/N]: y
╭─ Profile Removed ──────────╮
│ Name: local/careful-auto │
╰────────────────────────────╯
✓ OK Profile removed
agents automation-profile list [<REGEX>]
$ agents automation-profile list
╭─ Automation Profiles ──────────────────────────────────────────────────────────╮
│ Name Source Auto-Apply Sandbox Description │
│ ────────────────── ──────── ────────── ─────── ──────────────────────── │
│ manual built-in 1.0 yes Human-driven (default) │
│ review built-in 1.0 yes Auto-phase, manual decisions │
│ supervised built-in 1.0 yes Auto-plan, manual exec │
│ cautious built-in 1.0 yes Confidence-gated automation │
│ trusted built-in 1.0 yes Auto-exec, manual apply │
│ auto built-in 1.0 yes Full auto except apply │
│ ci built-in 0.0 yes Full auto, safe CI/CD │
│ full-auto built-in 0.0 no Complete automation │
│ local/careful-auto custom 0.8 yes Custom careful profile │
╰────────────────────────────────────────────────────────────────────────────────╯
╭─ Summary ───────────╮
│ Built-in: 8 │
│ Custom: 1 │
│ Total: 9 │
╰─────────────────────╯
✓ OK 9 profiles listed
agents automation-profile show <NAME>
$ agents automation-profile show trusted
╭─ Automation Profile ───────────────────────────────────────────╮
│ Name: trusted │
│ Source: built-in │
│ Description: Auto-exec, manual apply. Day-to-day development │
╰────────────────────────────────────────────────────────────────╯
╭─ Phase Transitions (thresholds) ─────╮
│ decompose_task: 0.0 │
│ create_tool: 0.0 │
│ select_tool: 1.0 │
╰──────────────────────────────────────╯
╭─ Decision Automation (thresholds) ───╮
│ edit_code: 0.0 │
│ execute_command: 0.0 │
╰──────────────────────────────────────╯
╭─ Self-Repair (thresholds) ───────────╮
│ create_file: 0.0 │
│ delete_content: 1.0 │
│ access_network: 1.0 │
│ modify_config: 0.0 │
│ approve_plan: 1.0 │
╰──────────────────────────────────────╯
╭─ Execution Controls (thresholds) ────╮
│ install_dependency: 0.0 │
│ require_sandbox: true │
│ require_checkpoints: true │
│ allow_unsafe_tools: false │
╰──────────────────────────────────────╯
✓ OK Profile loaded
agents config set <key> <value>
$ agents config set core.automation-profile trusted
╭─ Config Updated ──────────────────────╮
│ Key: core.automation-profile │
│ Value: trusted │
│ Previous: manual │
│ Source: config │
│ Scope: global │
╰───────────────────────────────────────╯
╭─ Effective ────────────────────────╮
│ Sessions: new sessions │
│ Plans: future plans (unless set) │
│ Existing: unchanged │
╰────────────────────────────────────╯
╭─ Saved To ──────────────────────────╮
│ File: ~/.cleveragents/config.toml │
│ Line: 8 │
╰─────────────────────────────────────╯
✓ OK Config updated
$ agents config set core.format table
╭─ Config Updated ─────────────────╮
│ Key: core.format │
│ Previous: rich │
│ New Value: table │
│ Scope: user (~/.cleveragents) │
╰──────────────────────────────────╯
✓ OK Set core.format = table
$ agents config set actor.default.invariant local/invariant-resolver
╭─ Config Updated ──────────────────────────────────╮
│ Key: actor.default.invariant │
│ Previous: (not set) │
│ New Value: local/invariant-resolver │
│ Scope: user (~/.cleveragents) │
╰───────────────────────────────────────────────────╯
✓ OK Set actor.default.invariant = local/invariant-resolver
agents config get <key>
$ agents config get core.automation-profile
╭─ Config ──────────────────────────╮
│ Key: core.automation-profile │
│ Value: trusted │
│ Source: config │
│ Overridden: no │
│ Type: string │
╰───────────────────────────────────╯
╭─ Origin ──────────────────────────╮
│ File: ~/.cleveragents/config.toml │
│ Line: 8 │
│ Default: supervised │
╰───────────────────────────────────╯
╭─ Resolution Chain ──────────────╮
│ 1. CLI flag: (not set) │
│ 2. Env var: (not set) │
│ 3. Config file: trusted │
│ 4. Default: supervised │
│ Winner: config file (level 3) │
╰─────────────────────────────────╯
✓ OK Config read
agents config list [--filter-values <REGEX>] [<REGEX>]
$ agents config list
╭─ Config ───────────────────────────────────────────────────╮
│ Key Value Source Modified │
│ ──────────────── ────────────────── ─────── ──────── │
│ core.automation-profile trusted config yes │
│ actor.default.invariant local/reconciler config yes │
│ core.log.level FATAL default no │
╰────────────────────────────────────────────────────────────╯
╭─ Overrides ─────╮
│ Env: none │
│ CLI Flags: none │
╰─────────────────╯
╭─ Config File ───────────────────────╮
│ Path: ~/.cleveragents/config.toml │
│ Size: 284 bytes │
│ Valid: yes │
╰─────────────────────────────────────╯
✓ OK 6 settings listed
agents invariant add [--global] [(--project|-p) PROJECT] [--plan PLAN_ID]...
[--action ACTION]... <INVARIANT_TEXT>
$ agents invariant add --global "All public APIs must maintain backward compatibility"
╭─ Invariant Added ──────────────────────────────────────────────────────╮
│ Invariant: All public APIs must maintain backward compatibility │
│ Scope: global │
│ ID: inv_01HXM9A1B │
╰────────────────────────────────────────────────────────────────────────╯
✓ OK Invariant added
$ agents invariant add --project local/api-service "All endpoints must validate auth tokens"
╭─ Invariant Added ──────────────────────────────────────────────╮
│ Project: local/api-service │
│ Invariant: All endpoints must validate auth tokens │
│ Scope: project │
│ ID: inv_01HXM9A2C │
╰────────────────────────────────────────────────────────────────╯
✓ OK Invariant added
$ agents invariant add --plan 01HXM8C2ZK4Q7C2B3F2R4VYV6J "All database queries must use parameterized statements"
╭─ Invariant Added ─────────────────────────────────────────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │
│ Invariant: All database queries must use parameterized statements │
│ Scope: plan │
│ ID: inv_01HXM9G3A │
╰───────────────────────────────────────────────────────────────────────╯
✓ OK Invariant added
$ agents invariant add --action local/code-coverage "Test files must not import production secrets"
╭─ Invariant Added ──────────────────────────────────────────────────────╮
│ Action: local/code-coverage │
│ Invariant: Test files must not import production secrets │
│ Scope: action │
│ ID: inv_01HXM9H4B │
╰────────────────────────────────────────────────────────────────────────╯
✓ OK Invariant added
agents invariant list [--global] [(--project|-p) PROJECT] [--plan PLAN_ID] [--action ACTION]
[--effective] [<REGEX>]
$ agents invariant list --global
╭─ Global Invariants ──────────────────────────────────────────────────────╮
│ ID Text │
│ ────────────── ──────────────────────────────────────────────────── │
│ inv_01HXM9A1B All public APIs must maintain backward compatibility │
│ inv_01HXM9A1C Payment processing must be idempotent │
╰──────────────────────────────────────────────────────────────────────────╯
✓ OK 2 invariants
$ agents invariant list --plan 01HXM8C2ZK4Q7C2B3F2R4VYV6J --effective
╭─ Effective Invariants (Plan 01HXM8C2ZK4Q7C2B3F2R4VYV6J) ──────────────────────────────────╮
│ ID Source Text │
│ ────────────── ─────── ────────────────────────────────────────────────────── │
│ inv_01HXM9A1B global All public APIs must maintain backward compatibility │
│ inv_01HXM9A2C project All endpoints must validate auth tokens │
│ inv_01HXM9G3A plan All database queries must use parameterized statements │
╰───────────────────────────────────────────────────────────────────────────────────────────╯
│ Conflicts Resolved: 1 │
│ Global "Use shared DB pool" overridden by plan "All database queries must use │
│ parameterized statements" │
✓ OK 3 effective invariants (1 global, 1 project, 1 plan; 1 conflict resolved)
agents invariant remove [--yes|-y] <INVARIANT_ID>
$ agents invariant remove inv_01HXM9A1C
Remove invariant inv_01HXM9A1C ("Payment processing must be idempotent", scope: global)? [y/N]: y
╭─ Invariant Removed ──────────────────────────────────────────────╮
│ Removed: Payment processing must be idempotent │
│ Scope: global │
│ ID: inv_01HXM9A1C │
╰──────────────────────────────────────────────────────────────────╯
✓ OK Invariant removed