polyctl 0.7.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- polyctl/__init__.py +7 -0
- polyctl/__main__.py +5 -0
- polyctl/a2a.py +226 -0
- polyctl/a2a_mcp.py +546 -0
- polyctl/acp.py +417 -0
- polyctl/adapters/README.md +101 -0
- polyctl/adapters/aider.json +32 -0
- polyctl/adapters/amazon-q.json +15 -0
- polyctl/adapters/amp.json +16 -0
- polyctl/adapters/antigravity.json +120 -0
- polyctl/adapters/claude-code.json +229 -0
- polyctl/adapters/cloud-generic.json +57 -0
- polyctl/adapters/codex.json +47 -0
- polyctl/adapters/command-code.json +45 -0
- polyctl/adapters/copilot.json +17 -0
- polyctl/adapters/cursor-agent.json +29 -0
- polyctl/adapters/deepseek.json +13 -0
- polyctl/adapters/droid.json +34 -0
- polyctl/adapters/gemini.json +30 -0
- polyctl/adapters/grok.json +22 -0
- polyctl/adapters/hermes.json +34 -0
- polyctl/adapters/kilocode.json +30 -0
- polyctl/adapters/kimi.json +23 -0
- polyctl/adapters/kiro.json +332 -0
- polyctl/adapters/ollama.json +29 -0
- polyctl/adapters/omp.json +34 -0
- polyctl/adapters/openai-api.json +68 -0
- polyctl/adapters/opencode.json +162 -0
- polyctl/adapters/pi.json +24 -0
- polyctl/adapters/pr-agent.json +54 -0
- polyctl/adapters/profiles.json +9 -0
- polyctl/adapters/qoder.json +163 -0
- polyctl/adapters/qwen.json +27 -0
- polyctl/adapters/reasonix.json +25 -0
- polyctl/adapters/rewriters/rtk.json +24 -0
- polyctl/adapters/trae.json +31 -0
- polyctl/adapters/vendors.json +42 -0
- polyctl/adapters/warp.json +88 -0
- polyctl/allowlist.py +1756 -0
- polyctl/api_review.py +920 -0
- polyctl/cli.py +835 -0
- polyctl/conformance_harness.py +9 -0
- polyctl/demo.py +503 -0
- polyctl/drivers.py +146 -0
- polyctl/email.py +160 -0
- polyctl/features.py +98 -0
- polyctl/journal.py +144 -0
- polyctl/language.py +945 -0
- polyctl/lib.py +1296 -0
- polyctl/matrix.py +660 -0
- polyctl/mcp.py +1362 -0
- polyctl/ntfy.py +169 -0
- polyctl/outbound.py +39 -0
- polyctl/parts/__init__.py +5 -0
- polyctl/parts/cli_authority.py +2615 -0
- polyctl/parts/cli_channels.py +1325 -0
- polyctl/parts/cli_checks.py +2293 -0
- polyctl/parts/cli_completion.py +686 -0
- polyctl/parts/cli_evidence.py +141 -0
- polyctl/parts/cli_gain.py +375 -0
- polyctl/parts/cli_harness.py +392 -0
- polyctl/parts/cli_hooks.py +1816 -0
- polyctl/parts/cli_install.py +638 -0
- polyctl/parts/cli_lanes.py +106 -0
- polyctl/parts/cli_maintenance.py +2536 -0
- polyctl/parts/cli_next.py +248 -0
- polyctl/parts/cli_pr.py +53 -0
- polyctl/parts/cli_project.py +2857 -0
- polyctl/parts/cli_review.py +5158 -0
- polyctl/parts/cli_status.py +898 -0
- polyctl/parts/lib_adapters.py +2933 -0
- polyctl/parts/lib_alarms.py +2106 -0
- polyctl/parts/lib_events.py +224 -0
- polyctl/parts/lib_evidence.py +412 -0
- polyctl/parts/lib_gates.py +2099 -0
- polyctl/parts/lib_lanes.py +829 -0
- polyctl/parts/lib_mail.py +1541 -0
- polyctl/parts/lib_next.py +652 -0
- polyctl/parts/lib_pr.py +331 -0
- polyctl/parts/lib_slices.py +3337 -0
- polyctl/parts/lib_state.py +2415 -0
- polyctl/parts/lib_transcript.py +4118 -0
- polyctl/pressure.py +325 -0
- polyctl/prices.json +47 -0
- polyctl/procs.py +1194 -0
- polyctl/settings.py +505 -0
- polyctl/skill/SKILL.md +365 -0
- polyctl/skillkit.py +503 -0
- polyctl/storage.py +2055 -0
- polyctl/telegram.py +327 -0
- polyctl/tiers.py +123 -0
- polyctl/verdicts.py +41 -0
- polyctl/watchdog.py +3887 -0
- polyctl/web.py +337 -0
- polyctl-0.7.0.dist-info/METADATA +235 -0
- polyctl-0.7.0.dist-info/RECORD +99 -0
- polyctl-0.7.0.dist-info/WHEEL +4 -0
- polyctl-0.7.0.dist-info/entry_points.txt +5 -0
- polyctl-0.7.0.dist-info/licenses/LICENSE +21 -0
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
{
|
|
2
|
+
"project_config": [".factory", "AGENTS.md", "CLAUDE.md"],
|
|
3
|
+
"id": "droid", "name": "Factory Droid", "contract": 1, "verified": "untested",
|
|
4
|
+
"disclaimer": "Written from the documented interface, not verified against an install. Flags drift; correct and open a PR.",
|
|
5
|
+
"sources": ["https://docs.factory.ai/reference/cli-reference", "https://docs.factory.ai/droid-exec/overview",
|
|
6
|
+
"https://docs.factory.ai/harness/agents-md", "https://docs.factory.ai/harness/hooks"],
|
|
7
|
+
"detect": { "headless": ["exec"] },
|
|
8
|
+
"send": { "argv": ["droid", "exec", "{prompt}"], "cwd_matters": true,
|
|
9
|
+
"stdin": { "replaces": ["{prompt}"], "with": [],
|
|
10
|
+
"note": "Verified from the droid exec overview (docs.factory.ai/cli/droid-exec/overview), read 2026-09-17: its Pipe quickstart pipes the prompt to `droid exec` with no prompt argument." },
|
|
11
|
+
"file": { "replaces": ["{prompt}"], "with": ["-f", "{prompt_file}"],
|
|
12
|
+
"note": "Verified from the same overview and the CLI reference (docs.factory.ai/reference/cli-reference): -f, --file <path> reads the prompt from a file." } },
|
|
13
|
+
"resume": { "argv": ["droid", "exec", "-s", "{session}", "{prompt}"], "note": "exec resumes by --session-id and still takes a prompt; --fork <id> branches instead",
|
|
14
|
+
"file": { "replaces": ["{prompt}"], "with": ["-f", "{prompt_file}"],
|
|
15
|
+
"note": "As send: -f is an option of exec. Resuming with piped input is not documented, so resume declares no stdin." } },
|
|
16
|
+
"options": {
|
|
17
|
+
"trust_none": null,
|
|
18
|
+
"trust_none_why": "droid exec without --auto is documented as read-only by default, but no flag states it, so a reviewer's argv cannot prove it; --restrict-tools takes the tool ids an install lists with --list-tools. Ineligible for the reviewer role until that is verified against an install.",
|
|
19
|
+
"model": ["-m", "{model}"],
|
|
20
|
+
"effort": ["-r", "{effort}"],
|
|
21
|
+
"effort_note": "under exec -r is --reasoning-effort; interactively -r is resume",
|
|
22
|
+
"output_json": ["-o", "stream-json"],
|
|
23
|
+
"trust_some": ["--auto", "{mode}"], "mode_values": ["low", "medium", "high"],
|
|
24
|
+
"trust_all": ["--skip-permissions-unsafe"],
|
|
25
|
+
"unattended": ["--auto", "medium"],
|
|
26
|
+
"bypass": {
|
|
27
|
+
"--auto": { "roles": ["implementer"],
|
|
28
|
+
"why": "An autonomy level, in place of --skip-permissions-unsafe, which skips every permission check: --auto medium lets a droid exec turn edit files, install dependencies, build, test and commit locally, and a run that needs more stops with an error instead of asking. Read on 2026-09-17 from docs.factory.ai/cli/droid-exec/overview and docs.factory.ai/reference/cli-reference." }
|
|
29
|
+
}
|
|
30
|
+
},
|
|
31
|
+
"transcript": { "kind": "jsonl", "path": "~/.factory/projects/**/session.jsonl", "todo": "the path is the hooks documentation's example; confirm it against an install" },
|
|
32
|
+
"busy": { "mtime_glob": "~/.factory/projects/**/*.jsonl", "idle_seconds": 240 },
|
|
33
|
+
"directives": { "steering_files": ["AGENTS.md", "CLAUDE.md", ".factory/AGENTS.md", "~/.factory/AGENTS.md"], "note": "searched from the working directory up to the git root" }
|
|
34
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
{
|
|
2
|
+
"project_config": [".gemini", "GEMINI.md"],
|
|
3
|
+
"id": "gemini", "name": "Google Gemini CLI", "verified": "untested",
|
|
4
|
+
"disclaimer": "Written from documented interface, not verified against an install.",
|
|
5
|
+
"detect": { "headless": ["--prompt", "-p"] },
|
|
6
|
+
"send": { "argv": ["gemini", "--prompt", "{prompt}"],
|
|
7
|
+
"stdin": { "replaces": ["--prompt", "{prompt}"], "with": [],
|
|
8
|
+
"note": "Verified from the CLI reference (github.com/google-gemini/gemini-cli, docs/cli/cli-reference.md), read 2026-09-17: `cat file | gemini` processes piped content, and --prompt is appended to stdin input; docs/cli/headless.md starts headless mode in a non-TTY environment." } },
|
|
9
|
+
"resume": { "argv": ["gemini", "--resume", "{session}", "--prompt", "{prompt}"],
|
|
10
|
+
"note": "Measured from the CLI reference (github.com/google-gemini/gemini-cli, docs/cli/cli-reference.md, main branch, read 2026-10-16): -r/--resume resumes a previous session by id, index or 'latest' - `gemini -r \"<session-id>\" \"query\"` - and resumes by index where the id is unknown. Until this reading the argv was the send's, which started a new session instead of resuming one.",
|
|
11
|
+
"stdin": { "replaces": ["--prompt", "{prompt}"], "with": [], "note": "As send: with -p/--prompt the prompt may come from stdin, and a prompt argument is appended to it." } },
|
|
12
|
+
"quota": { "provider": "gemini" },
|
|
13
|
+
"options": {
|
|
14
|
+
"trust_none": null,
|
|
15
|
+
"trust_none_why": "no flag verified to deny every tool",
|
|
16
|
+
"model": ["--model", "{model}"],
|
|
17
|
+
"effort": null,
|
|
18
|
+
"effort_note": "No reasoning-effort flag; model choice carries the tradeoff.",
|
|
19
|
+
"output_json": ["--output-format", "json"],
|
|
20
|
+
"trust_all": ["--yolo"],
|
|
21
|
+
"bypass": {
|
|
22
|
+
"--yolo": { "roles": ["implementer"],
|
|
23
|
+
"why": "Kept: --approval-mode auto_edit approves edits and refuses every shell command when nobody attends, and allowing the few an implementer's gates need takes a policy file (policyPaths, or --policy) polyctl does not write, or --allowed-tools, which is deprecated; --yolo is deprecated too, for --approval-mode=yolo. Read on 2026-09-17 from github.com/google-gemini/gemini-cli (docs/cli/cli-reference.md, docs/reference/policy-engine.md, packages/core/src/policy/policies/write.toml)." }
|
|
24
|
+
},
|
|
25
|
+
"all_files": ["--all-files"]
|
|
26
|
+
},
|
|
27
|
+
"transcript": { "kind": "unknown", "candidates": ["~/.gemini/tmp", "~/.gemini/sessions"] },
|
|
28
|
+
"busy": { "kind": "unknown", "fallback": "synchronous print mode; orchestrator owns idle state" },
|
|
29
|
+
"directives": { "steering_files": ["GEMINI.md", "~/.gemini/GEMINI.md"], "config": "~/.gemini/settings.json" }
|
|
30
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "grok", "name": "Grok CLI (superagent-ai)", "contract": 1, "verified": "untested",
|
|
3
|
+
"disclaimer": "Written from the documented interface and, where the README is silent, the source; not verified against an install. Flags drift; correct and open a PR.",
|
|
4
|
+
"notes": "A community project; its README says it is not affiliated with xAI (npm grok-dev). --model is defined in src/index.ts and absent from the README, which names GROK_MODEL instead; the session store is read from src/storage/db.ts.",
|
|
5
|
+
"sources": ["https://github.com/superagent-ai/grok-cli",
|
|
6
|
+
"https://github.com/superagent-ai/grok-cli/blob/main/src/index.ts",
|
|
7
|
+
"https://github.com/superagent-ai/grok-cli/blob/main/src/storage/db.ts"],
|
|
8
|
+
"detect": { "headless": ["-p"] },
|
|
9
|
+
"send": { "argv": ["grok", "-p", "{prompt}"], "cwd_matters": true },
|
|
10
|
+
"resume": { "argv": ["grok", "-s", "{session}", "-p", "{prompt}"], "continue_last": ["grok", "--session", "latest", "-p", "{prompt}"] },
|
|
11
|
+
"options": {
|
|
12
|
+
"trust_none": null,
|
|
13
|
+
"trust_none_why": "No documented read-only or tool-less mode; --sandbox isolates a run in a microVM but does not stop it writing. Ineligible for the reviewer role until one exists.",
|
|
14
|
+
"model": ["-m", "{model}"],
|
|
15
|
+
"output_json": ["--format", "json"],
|
|
16
|
+
"max_steps": ["--max-tool-rounds", "{max_steps}"],
|
|
17
|
+
"trust_all": null, "trust_all_why": "no documented approval flag"
|
|
18
|
+
},
|
|
19
|
+
"transcript": { "kind": "sqlite", "path": "~/.grok/grok.db", "access": "READ-ONLY. A second writer corrupts the agent's own state.", "todo": "map the schema against an install" },
|
|
20
|
+
"busy": { "mtime_file": "~/.grok/grok.db-wal", "idle_seconds": 240 },
|
|
21
|
+
"directives": { "steering_files": ["AGENTS.md", "AGENTS.override.md", "~/.grok/AGENTS.md"], "note": "AGENTS.md files merge from the git root down to the working directory" }
|
|
22
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
{
|
|
2
|
+
"project_config": [".hermes", ".hermes.md", "HERMES.md", "AGENTS.override.md", "AGENTS.md", "CLAUDE.md", ".cursorrules"],
|
|
3
|
+
"id": "hermes", "name": "Hermes Agent (Nous Research)", "contract": 1, "verified": "untested",
|
|
4
|
+
"disclaimer": "Written from the documented interface, not verified against an install. Flags drift; correct and open a PR.",
|
|
5
|
+
"notes": "-z prints only the final answer. -p is --profile, not a prompt, and -q alone on a terminal opens an interactive session. A single-query session refuses dangerous commands by default (approvals.single_query_mode: deny).",
|
|
6
|
+
"sources": ["https://hermes-agent.nousresearch.com/docs/reference/cli-commands",
|
|
7
|
+
"https://hermes-agent.nousresearch.com/docs/user-guide/sessions",
|
|
8
|
+
"https://hermes-agent.nousresearch.com/docs/user-guide/features/context-files",
|
|
9
|
+
"https://hermes-agent.nousresearch.com/docs/user-guide/security",
|
|
10
|
+
"https://hermes-agent.nousresearch.com/docs/reference/toolsets-reference"],
|
|
11
|
+
"detect": { "headless": ["-z", "-Q", "--oneshot"] },
|
|
12
|
+
"send": { "argv": ["hermes", "-z", "{prompt}"], "cwd_matters": true },
|
|
13
|
+
"resume": { "argv": ["hermes", "chat", "--resume", "{session}", "-Q", "-q", "{prompt}"],
|
|
14
|
+
"note": "resuming under -z is not documented; chat --resume takes an id, a title or latest",
|
|
15
|
+
"stdin": { "replaces": ["-q", "{prompt}"], "with": ["--query-file", "-"],
|
|
16
|
+
"note": "Verified from the CLI command reference (hermes-agent.nousresearch.com/docs/reference/cli-commands), read 2026-09-17: hermes chat --query-file PATH reads the query from a file, - for stdin, with nothing shell-interpreted. -z takes its prompt as an argument only, so send declares none." },
|
|
17
|
+
"file": { "replaces": ["-q", "{prompt}"], "with": ["--query-file", "{prompt_file}"],
|
|
18
|
+
"note": "Verified from the same reference, as stdin." } },
|
|
19
|
+
"options": {
|
|
20
|
+
"trust_none": ["--toolsets", "safe"],
|
|
21
|
+
"trust_none_note": "the safe toolset has web search, vision and image generation, and no file writing, terminal or code execution",
|
|
22
|
+
"model": ["-m", "{model}"],
|
|
23
|
+
"provider": ["--provider", "{provider}"],
|
|
24
|
+
"effort": null, "effort_why": "chat has no flag; agent.reasoning_effort in the configuration",
|
|
25
|
+
"output_json": ["--format", "stream-json"],
|
|
26
|
+
"trust_all": ["--yolo"],
|
|
27
|
+
"unattended": [],
|
|
28
|
+
"unattended_note": "No --yolo: a resumed chat -Q -q turn makes edits and runs ordinary commands without asking and refuses a dangerous command outright, as approvals.single_query_mode deny, the default, says; a person's configuration can widen that (approvals.mode off). Read on 2026-09-17 from hermes-agent.nousresearch.com/docs/user-guide/security and github.com/NousResearch/hermes-agent (tools/approval.py)."
|
|
29
|
+
},
|
|
30
|
+
"transcript": { "kind": "sqlite", "path": "~/.hermes/state.db", "access": "READ-ONLY. A second writer corrupts the agent's own state.", "todo": "map the schema against an install" },
|
|
31
|
+
"busy": { "mtime_file": "~/.hermes/state.db-wal", "idle_seconds": 240 },
|
|
32
|
+
"directives": { "steering_files": [".hermes.md", "HERMES.md", "AGENTS.override.md", "AGENTS.md", "CLAUDE.md", ".cursorrules"],
|
|
33
|
+
"note": "only the first match loads, plus a global SOUL.md; --ignore-rules loads none" }
|
|
34
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
{
|
|
2
|
+
"project_config": [".kilocode", ".kilo", "kilo.json", "kilo.jsonc", "AGENT.md", "AGENTS.md"],
|
|
3
|
+
"id": "kilocode", "name": "Kilo Code CLI", "contract": 1, "verified": "untested",
|
|
4
|
+
"disclaimer": "Written from the documented interface, not verified against an install. Flags drift; correct and open a PR.",
|
|
5
|
+
"notes": "An opencode fork (Kilo-Org/kilocode, npm @kilocode/cli). The command is kilo, with kilocode as an alias.",
|
|
6
|
+
"sources": ["https://kilo.ai/docs/code-with-ai/platforms/cli", "https://kilo.ai/docs/code-with-ai/platforms/cli-reference",
|
|
7
|
+
"https://kilo.ai/docs/code-with-ai/agents/using-agents", "https://kilo.ai/docs/code-with-ai/agents/session-history",
|
|
8
|
+
"https://kilo.ai/docs/customize/agents-md"],
|
|
9
|
+
"detect": { "binaries": ["kilo", "kilocode"], "headless": ["run"] },
|
|
10
|
+
"send": { "argv": ["kilo", "run", "{prompt}"], "cwd_matters": true },
|
|
11
|
+
"resume": { "argv": ["kilo", "run", "-s", "{session}", "{prompt}"],
|
|
12
|
+
"note": "the CLI page says --continue takes neither a prompt nor --auto while the generated reference lists both under kilo run; resume by id instead" },
|
|
13
|
+
"options": {
|
|
14
|
+
"trust_none": ["--agent", "ask"],
|
|
15
|
+
"trust_none_note": "the ask agent blocks every write",
|
|
16
|
+
"model": ["-m", "{model}"], "model_format": "provider/model",
|
|
17
|
+
"effort": ["--variant", "{effort}"], "effort_note": "a provider-specific reasoning effort",
|
|
18
|
+
"output_json": ["--format", "json"],
|
|
19
|
+
"trust_all": ["--auto"],
|
|
20
|
+
"trust_all_note": "without --auto a non-interactive run refuses every permission request",
|
|
21
|
+
"bypass": {
|
|
22
|
+
"--auto": { "roles": ["implementer"],
|
|
23
|
+
"why": "Kept: without it a non-interactive run rejects every permission request, and by default every shell command that is not read-only asks, so an implementer could edit but run none of its gates; narrowing it takes a permission block in kilo.json or the global configuration, which polyctl does not write. Read on 2026-09-17 from kilo.ai/docs/code-with-ai/platforms/cli-reference and kilo.ai/docs/customize/agent-permissions." }
|
|
24
|
+
}
|
|
25
|
+
},
|
|
26
|
+
"transcript": { "kind": "sqlite", "path": "~/.local/share/kilo/kilo.db", "locate": ["kilo", "db", "path"],
|
|
27
|
+
"access": "READ-ONLY. A second writer corrupts the agent's own state.", "todo": "map the schema against an install" },
|
|
28
|
+
"busy": { "mtime_file": "~/.local/share/kilo/kilo.db-wal", "idle_seconds": 240 },
|
|
29
|
+
"directives": { "steering_files": ["AGENTS.md", "AGENT.md"], "note": "AGENTS.md files in subdirectories load as they are reached" }
|
|
30
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"project_config": [".kimi-code", "AGENTS.md"],
|
|
3
|
+
"id": "kimi", "name": "Kimi Code CLI", "contract": 1, "verified": "untested",
|
|
4
|
+
"disclaimer": "Written from the documented interface, not verified against an install. Flags drift; correct and open a PR.",
|
|
5
|
+
"notes": "The kimi binary belongs to Kimi Code CLI (MoonshotAI/kimi-code); the older kimi-cli's README says it is being wound down in its favour. The older CLI's flags differ: there -c is --command, not continue, and --print approves every tool.",
|
|
6
|
+
"sources": ["https://moonshotai.github.io/kimi-code/en/reference/kimi-command",
|
|
7
|
+
"https://moonshotai.github.io/kimi-code/en/configuration/data-locations",
|
|
8
|
+
"https://moonshotai.github.io/kimi-code/en/customization/agents"],
|
|
9
|
+
"detect": { "headless": ["-p", "--prompt"] },
|
|
10
|
+
"send": { "argv": ["kimi", "-p", "{prompt}"], "cwd_matters": true },
|
|
11
|
+
"resume": { "argv": ["kimi", "--session", "{session}", "-p", "{prompt}"], "continue_last": ["kimi", "--continue", "-p", "{prompt}"] },
|
|
12
|
+
"options": {
|
|
13
|
+
"trust_none": null,
|
|
14
|
+
"trust_none_why": "--prompt runs under the auto permission policy, and --plan, the read-only mode, is refused together with --prompt; no headless read-only mode is documented. Ineligible for the reviewer role.",
|
|
15
|
+
"model": ["--model", "{model}"],
|
|
16
|
+
"effort": null, "effort_why": "no flag; [thinking] effort in the configuration",
|
|
17
|
+
"output_json": ["--output-format", "stream-json"],
|
|
18
|
+
"trust_all": null, "trust_all_why": "--yolo and --auto are refused together with --prompt, which already runs under auto"
|
|
19
|
+
},
|
|
20
|
+
"transcript": { "kind": "jsonl", "path": "~/.kimi-code/sessions/{workdir_key}/{session}/agents/main/wire.jsonl", "todo": "confirm the work-directory key, the session index and the record shape against an install" },
|
|
21
|
+
"busy": { "mtime_file": "wire.jsonl", "idle_seconds": 240 },
|
|
22
|
+
"directives": { "steering_files": ["AGENTS.md", ".kimi-code/AGENTS.md", "~/.kimi-code/AGENTS.md", "~/.agents/AGENTS.md"] }
|
|
23
|
+
}
|
|
@@ -0,0 +1,332 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "kiro",
|
|
3
|
+
"name": "Kiro CLI",
|
|
4
|
+
"project_config": [".kiro", "AGENTS.md"],
|
|
5
|
+
"verified": "full",
|
|
6
|
+
"actor_name": "kiro",
|
|
7
|
+
"verified_version": "kiro-cli (Kiro CLI), IDE 1.0.411",
|
|
8
|
+
"notes": "Reference adapter. Every capability exercised in a multi-week production run.",
|
|
9
|
+
"send": {
|
|
10
|
+
"argv": [
|
|
11
|
+
"kiro-cli",
|
|
12
|
+
"chat",
|
|
13
|
+
"--no-interactive",
|
|
14
|
+
"{prompt}"
|
|
15
|
+
],
|
|
16
|
+
"cwd_matters": true
|
|
17
|
+
},
|
|
18
|
+
"resume": {
|
|
19
|
+
"argv": [
|
|
20
|
+
"kiro-cli",
|
|
21
|
+
"chat",
|
|
22
|
+
"--resume-id",
|
|
23
|
+
"{session}",
|
|
24
|
+
"--no-interactive",
|
|
25
|
+
"{prompt}"
|
|
26
|
+
],
|
|
27
|
+
"note": "Injects into the same store the IDE uses; the IDE panel may not render an externally started turn even though it runs correctly."
|
|
28
|
+
},
|
|
29
|
+
"list_sessions": {
|
|
30
|
+
"argv": [
|
|
31
|
+
"kiro-cli",
|
|
32
|
+
"chat",
|
|
33
|
+
"--list-sessions",
|
|
34
|
+
"--format",
|
|
35
|
+
"json"
|
|
36
|
+
],
|
|
37
|
+
"all_workspaces_flag": "--all-cwds",
|
|
38
|
+
"returns": "[{cwd, sessions:[{sessionId, source, title, updatedAt, status}]}]"
|
|
39
|
+
},
|
|
40
|
+
"list_models": {
|
|
41
|
+
"argv": [
|
|
42
|
+
"kiro-cli",
|
|
43
|
+
"chat",
|
|
44
|
+
"--list-models",
|
|
45
|
+
"--format",
|
|
46
|
+
"json"
|
|
47
|
+
]
|
|
48
|
+
},
|
|
49
|
+
"options": {
|
|
50
|
+
"model": [
|
|
51
|
+
"--model",
|
|
52
|
+
"{model}"
|
|
53
|
+
],
|
|
54
|
+
"effort": [
|
|
55
|
+
"--effort",
|
|
56
|
+
"{effort}"
|
|
57
|
+
],
|
|
58
|
+
"effort_values": [
|
|
59
|
+
"low",
|
|
60
|
+
"medium",
|
|
61
|
+
"high",
|
|
62
|
+
"xhigh",
|
|
63
|
+
"max"
|
|
64
|
+
],
|
|
65
|
+
"agent_profile": [
|
|
66
|
+
"--agent",
|
|
67
|
+
"{agent}"
|
|
68
|
+
],
|
|
69
|
+
"output_json": [
|
|
70
|
+
"--output-format",
|
|
71
|
+
"stream-json"
|
|
72
|
+
],
|
|
73
|
+
"signed_out": {
|
|
74
|
+
"patterns": ["Opening browser\\.\\.\\.", "Auth portal timed out", "OAuth error"],
|
|
75
|
+
"signin": "kiro-cli login",
|
|
76
|
+
"note": "Measured on kiro-cli 2.27.1, 2026-10-07: with its sign-in expired, a review printed 'Opening browser... | Press (^) + C to cancel' on stdout and waited ten minutes for a person before 'error: OAuth error: Auth portal timed out' on stderr and exit 1. Only lines that are no JSON are read for it: the answer itself comes in stream-json lines, which may quote these words."
|
|
77
|
+
},
|
|
78
|
+
"answer_stream": {
|
|
79
|
+
"argv": ["--output-format", "stream-json"],
|
|
80
|
+
"note": "Measured on kiro-cli 2.27.1, 2026-10-05: the text output ran a turn's messages together where a tool call came between them ('I will read the file now.Done reading.'), and runFinished.finalText does too. stream-json writes each message chunk and each tool call as an ACP session update, {type: sessionUpdate, data: {sessionId, update}}, so a reader can break the text where a tool call fell.",
|
|
81
|
+
"transient": ["failed to generate a response", "(?i)\\brate.?limit", "(?i)throttl", "(?i)temporarily unavailable"],
|
|
82
|
+
"transient_note": "A run that ends on a runError whose message matches one of these is a passing failure of the provider, retried as a reviewer that exits 75 is. Measured on kiro-cli 2.27.1, 2026-10-05: a Sol review exited 1 after six minutes on `Internal error (code -32603): Kiro failed to generate a response`."
|
|
83
|
+
},
|
|
84
|
+
"pin": {
|
|
85
|
+
"reviewer": ["--output-format", "stream-json"],
|
|
86
|
+
"note": "A reviewer answers in session updates (answer_stream): read as text, a verdict written after a remark went on from the remark's last word, and the review was asked again and paid for twice."
|
|
87
|
+
},
|
|
88
|
+
"reviewer_agent": {
|
|
89
|
+
"argv": ["--agent", "{agent}"],
|
|
90
|
+
"acp": true,
|
|
91
|
+
"path": ".kiro/agents/{agent}.json",
|
|
92
|
+
"config": {
|
|
93
|
+
"name": "{agent}",
|
|
94
|
+
"description": "polyctl's reviewer: it reads, and has no tool that writes, runs a command or reaches a server",
|
|
95
|
+
"prompt": null,
|
|
96
|
+
"mcpServers": {},
|
|
97
|
+
"tools": ["read", "grep", "glob"],
|
|
98
|
+
"toolAliases": {},
|
|
99
|
+
"allowedTools": [],
|
|
100
|
+
"resources": [],
|
|
101
|
+
"toolsSettings": {},
|
|
102
|
+
"includeMcpJson": false,
|
|
103
|
+
"model": null
|
|
104
|
+
},
|
|
105
|
+
"note": "Measured on kiro-cli 2.27.1, 2026-10-05: with --no-interactive, a tool --trust-tools= leaves untrusted runs all the same - a `touch` made its file, and reviewers ran tests, built virtual environments under /tmp and installed packages. Run as this agent, with --output-format stream-json, it read the file it was asked to, had no tool to write with, and made nothing. polyctl writes it into the reviewer's own directory for each run, after the candidate's tree, under a name the tree cannot know."
|
|
106
|
+
},
|
|
107
|
+
"trust_none": [
|
|
108
|
+
"--trust-tools="
|
|
109
|
+
],
|
|
110
|
+
"trust_some": [
|
|
111
|
+
"--trust-tools={tools}"
|
|
112
|
+
],
|
|
113
|
+
"trust_all": [
|
|
114
|
+
"--trust-all-tools"
|
|
115
|
+
],
|
|
116
|
+
"bypass": {
|
|
117
|
+
"--trust-all-tools": { "roles": ["implementer"],
|
|
118
|
+
"why": "Kept, as nothing narrower lets an unattended implementer run its gates from the command line: --trust-tools narrows by tool and not by command, so trusting the shell tool trusts every command, and a command allowlist (toolsSettings allowedCommands with denyByDefault) lives only in a custom agent file polyctl does not write. A 2.x turn left waiting for an approval hangs (kirodotdev/Kiro issue 7483); the 3.0 early release's permissions.yaml denies an ask when nobody attends, but its sessions do not resume 2.x's. polyctl commit and the commit hook hold commits (polyctl doctor: actor-grant:implementer). Read on 2026-09-17 from kiro.dev/docs/cli/headless, kiro.dev/docs/custom-agents/configuration-reference and kiro.dev/docs/cli/v3/permissions." }
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
"transcript": {
|
|
122
|
+
"kind": "jsonl",
|
|
123
|
+
"path": "~/.kiro/sessions/{workspace_hash}/{session}/messages.jsonl",
|
|
124
|
+
"workspace_hash": "opaque per-workspace directory; resolve via list_sessions cwd match",
|
|
125
|
+
"record": {
|
|
126
|
+
"time": "timestamp",
|
|
127
|
+
"kind": "payload.type",
|
|
128
|
+
"text_keys": [
|
|
129
|
+
"text",
|
|
130
|
+
"content",
|
|
131
|
+
"message"
|
|
132
|
+
]
|
|
133
|
+
},
|
|
134
|
+
"kinds": [
|
|
135
|
+
"user",
|
|
136
|
+
"assistant",
|
|
137
|
+
"tool_call",
|
|
138
|
+
"tool_result",
|
|
139
|
+
"session_metadata",
|
|
140
|
+
"usage_summary",
|
|
141
|
+
"session_event",
|
|
142
|
+
"turn_start",
|
|
143
|
+
"turn_end",
|
|
144
|
+
"sub_agent_start",
|
|
145
|
+
"sub_agent_complete",
|
|
146
|
+
"session_start",
|
|
147
|
+
"tombstone"
|
|
148
|
+
],
|
|
149
|
+
"messages": { "prompt": ["user"], "reply": ["assistant"] },
|
|
150
|
+
"turn": { "start": ["turn_start"], "end": ["turn_end"],
|
|
151
|
+
"bookkeeping": ["session_metadata", "usage_summary", "session_event", "session_start", "tombstone"] },
|
|
152
|
+
"tool_call": { "type": "tool_call", "name": "toolName", "args": "args",
|
|
153
|
+
"path_keys": ["path", "targetFile", "destinationPath"],
|
|
154
|
+
"write_tools": ["fs_write", "fs_append", "str_replace", "delete_file", "semantic_rename",
|
|
155
|
+
"smart_relocate"], "write_words": ["write"] },
|
|
156
|
+
"tail_bytes": 900000
|
|
157
|
+
},
|
|
158
|
+
"sessions": {
|
|
159
|
+
"kind": "workspace-meta",
|
|
160
|
+
"dir": "~/.kiro/sessions",
|
|
161
|
+
"meta": "session.json",
|
|
162
|
+
"transcript": "messages.jsonl",
|
|
163
|
+
"workspaces": "workspacePaths",
|
|
164
|
+
"title": "title",
|
|
165
|
+
"status": "status"
|
|
166
|
+
},
|
|
167
|
+
"busy": {
|
|
168
|
+
"meta": "~/.kiro/sessions/{workspace_hash}/{session}/session.json",
|
|
169
|
+
"status_field": "status",
|
|
170
|
+
"running_values": [
|
|
171
|
+
"in_progress"
|
|
172
|
+
],
|
|
173
|
+
"description_field": "description",
|
|
174
|
+
"mtime_file": "messages.jsonl",
|
|
175
|
+
"idle_seconds": 240,
|
|
176
|
+
"note": "status can remain in_progress across an idle gap; the mtime check is the reliable half."
|
|
177
|
+
},
|
|
178
|
+
"acp": { "argv": ["kiro-cli", "acp"], "measured": "kiro-cli 2.24.1 answered initialize, 2026-09-28" },
|
|
179
|
+
"detect": {
|
|
180
|
+
"dirs": [".kiro"],
|
|
181
|
+
"binaries": ["kiro-cli"],
|
|
182
|
+
"processes": ["kiro-cli"],
|
|
183
|
+
"headless": ["--no-interactive"]
|
|
184
|
+
},
|
|
185
|
+
"mcp": {
|
|
186
|
+
"file": ".kiro/settings/mcp.json",
|
|
187
|
+
"extra": { "env": {} },
|
|
188
|
+
"register": ["kiro-cli", "mcp", "add", "--name", "polyctl", "--scope", "workspace", "--command", "{exe}", "--args", "{args}"],
|
|
189
|
+
"register_note": "run only when the CLI is installed and the file does not exist yet; otherwise the entry is merged"
|
|
190
|
+
},
|
|
191
|
+
"directives": {
|
|
192
|
+
"steering_dir": ".kiro/steering",
|
|
193
|
+
"playbook": { "path": ".kiro/steering/polyctl-playbook.md", "header": "---\ninclusion: always\n---\n\n" },
|
|
194
|
+
"coordination": ".kiro/steering/polyctl-coordination.md",
|
|
195
|
+
"polyctl_files": [".kiro/steering/polyctl-coordination.md", ".kiro/steering/polyctl-playbook.md",
|
|
196
|
+
".kiro/steering/polyctl-single-writer.md", ".kiro/steering/polyctl-machine.md"],
|
|
197
|
+
"steering_format": "markdown with `inclusion: always` frontmatter",
|
|
198
|
+
"steering_inclusion": {
|
|
199
|
+
"field": "inclusion",
|
|
200
|
+
"default": "always",
|
|
201
|
+
"honoured": ["always"],
|
|
202
|
+
"unhonoured": "Kiro CLI 2.x, which this adapter runs, supports no inclusion mode and loads every steering file in every session; fileMatch, manual and auto hold in the IDE, and the first two in the 3.0 early release",
|
|
203
|
+
"skill_header": "---\ninclusion: manual\n---\n\n",
|
|
204
|
+
"note": "Modes: always, the default; fileMatch with fileMatchPattern, one pattern or a list; manual, included by #name in chat; auto, with name and description. Workspace steering is .kiro/steering and global steering ~/.kiro/steering; AGENTS.md is always loaded; a custom agent loads steering only through its resources. The steering page says Kiro CLI supports no inclusion mode and loads every steering file, while its capability table marks always, fileMatch and manual for the CLI: the 3.0 early release (kiro-cli --v3, beside 2.x) adds that front matter, and leaves auto to the engine. send and resume run 2.x, the newest CLI in the changelog being 2.21.4 of 2026-09-11. Read from kiro.dev/docs/steering, kiro.dev/docs/cli/v3 and kiro.dev/changelog/cli on 2026-09-17."
|
|
205
|
+
},
|
|
206
|
+
"agents_dir": ".kiro/agents",
|
|
207
|
+
"agent_format": {
|
|
208
|
+
"extension": ".json",
|
|
209
|
+
"commands": {
|
|
210
|
+
"hooks": "hooks are never imported: each runs a command when its trigger fires",
|
|
211
|
+
"mcpServers": "an MCP server is a command the CLI starts: never imported",
|
|
212
|
+
"includeMcpJson": "it loads every MCP server in ~/.kiro/settings/mcp.json and .kiro/settings/mcp.json, each a command the CLI starts: never imported",
|
|
213
|
+
"useLegacyMcpJson": "it loads the MCP servers of the legacy configuration, each a command the CLI starts: never imported"
|
|
214
|
+
},
|
|
215
|
+
"grants": {
|
|
216
|
+
"allowedTools": "the tools it uses without asking",
|
|
217
|
+
"toolsSettings": "the paths and commands its tools may use without asking",
|
|
218
|
+
"permissions": "the rules that allow or deny what its tools may do"
|
|
219
|
+
},
|
|
220
|
+
"context": { "field": "resources", "empty": "a custom agent loads no steering and no skills unless its resources name them" },
|
|
221
|
+
"loads": {
|
|
222
|
+
"prompt": "a file:// prompt is a file the agent loads as its instructions"
|
|
223
|
+
},
|
|
224
|
+
"note": "Workspace agents are .kiro/agents/<name>.json and global ones ~/.kiro/agents, the workspace's winning by name; name defaults to the file name and prompt is inline or a file:// URI. Fields: name, description, prompt, model, tools, toolAliases, allowedTools, toolsSettings, resources (file://, skill://, knowledgeBase), mcpServers, useLegacyMcpJson or includeMcpJson, hooks (agentSpawn, userPromptSubmit, preToolUse, postToolUse, stop), keyboardShortcut, welcomeMessage. The IDE ignores an agent's hooks. The 3.0 early release (kiro-cli --v3) reads a universal format that 2.x reads too (/upgrade-agent writes it), replaces toolsSettings with permissions, reads Markdown agents with YAML front matter as the IDE does, and moves hooks to .kiro/hooks. Read from kiro.dev/docs/custom-agents/configuration-reference and kiro.dev/docs/cli/v3 on 2026-09-17."
|
|
225
|
+
},
|
|
226
|
+
"hook_files": {
|
|
227
|
+
".kiro.hook": "an IDE hook in the 0.x format (when, then), which Kiro CLI does not read"
|
|
228
|
+
},
|
|
229
|
+
"hooks_dir": ".kiro/hooks",
|
|
230
|
+
"hooks_format": "{\"version\":\"v1\",\"hooks\":[{name,trigger,action:{type:\"agent\"|\"command\",prompt|command}}]}",
|
|
231
|
+
"triggers": [
|
|
232
|
+
"SessionStart",
|
|
233
|
+
"Stop",
|
|
234
|
+
"PostFileSave",
|
|
235
|
+
"PostFileCreate",
|
|
236
|
+
"PostFileDelete",
|
|
237
|
+
"PreToolUse",
|
|
238
|
+
"PostToolUse",
|
|
239
|
+
"UserPromptSubmit",
|
|
240
|
+
"PreTaskExec",
|
|
241
|
+
"PostTaskExec"
|
|
242
|
+
],
|
|
243
|
+
"warning": "File triggers fire only for changes made by the agent itself. A message dropped by an external process will NOT fire PostFileCreate — use SessionStart plus steering instead."
|
|
244
|
+
},
|
|
245
|
+
"telemetry": {
|
|
246
|
+
"context": {
|
|
247
|
+
"from": "transcript",
|
|
248
|
+
"type": "session_metadata",
|
|
249
|
+
"match": {
|
|
250
|
+
"key": "contextUsage"
|
|
251
|
+
},
|
|
252
|
+
"field": "value.usagePercentage",
|
|
253
|
+
"verified": true
|
|
254
|
+
},
|
|
255
|
+
"cost": {
|
|
256
|
+
"from": "transcript",
|
|
257
|
+
"type": "usage_summary",
|
|
258
|
+
"field": "promptTurnSummaries[].usage",
|
|
259
|
+
"unit": "credit",
|
|
260
|
+
"tools": "promptTurnSummaries[].usedTools",
|
|
261
|
+
"verified": true
|
|
262
|
+
},
|
|
263
|
+
"quota": {
|
|
264
|
+
"from": "command",
|
|
265
|
+
"argv": [
|
|
266
|
+
"keyflip",
|
|
267
|
+
"usage",
|
|
268
|
+
"--providers"
|
|
269
|
+
],
|
|
270
|
+
"cache_seconds": 300
|
|
271
|
+
},
|
|
272
|
+
"balance": {
|
|
273
|
+
"from": "none",
|
|
274
|
+
"note": "Plan balance is not written to disk. Never estimated; use keyflip for real quota windows."
|
|
275
|
+
},
|
|
276
|
+
"failure": {
|
|
277
|
+
"from": "transcript",
|
|
278
|
+
"type": "tool_result",
|
|
279
|
+
"field": "success",
|
|
280
|
+
"failed_when": false,
|
|
281
|
+
"text": "content",
|
|
282
|
+
"verified": true,
|
|
283
|
+
"note": "Structural verdict on every tool result. Never text-match for 'error' or 'failed' — the agent's own search patterns and passing test names contain both."
|
|
284
|
+
}
|
|
285
|
+
},
|
|
286
|
+
"billing": {
|
|
287
|
+
"unit": "credit",
|
|
288
|
+
"reset_day": 1,
|
|
289
|
+
"source": "api",
|
|
290
|
+
"api": {
|
|
291
|
+
"endpoint": "https://codewhisperer.us-east-1.amazonaws.com/",
|
|
292
|
+
"target": "AmazonCodeWhispererService.GetUsageLimits",
|
|
293
|
+
"content_type": "application/x-amz-json-1.0",
|
|
294
|
+
"auth": "Bearer <access_token> from the CLI's own store",
|
|
295
|
+
"token_store": "~/Library/Application Support/kiro-cli/data.sqlite3, auth_kv where key='kirocli:odic:token', field access_token",
|
|
296
|
+
"token_store_note": "Measured on macOS, 2026-10-16: the path stands on disk (21,942,272 bytes, mode 600), and the CLI binary (Kiro CLI.app's kiro-cli, 2.27.1) loads its builder-id token 'from the secret store' and names data.sqlite3 among its strings - but it resolves the store's directory at runtime and embeds no other platform's template, so the paths off macOS are unverified; polyctl reads this store read-only.",
|
|
297
|
+
"request": {
|
|
298
|
+
"profileArn": "from `kiro-cli whoami`"
|
|
299
|
+
},
|
|
300
|
+
"driver": "usage-limits",
|
|
301
|
+
"token": { "sqlite": "~/Library/Application Support/kiro-cli/data.sqlite3", "table": "auth_kv",
|
|
302
|
+
"key": "kirocli:odic:token", "field": "access_token", "expires": "expires_at" },
|
|
303
|
+
"profile": { "argv": ["kiro-cli", "whoami"], "prefix": "arn:aws:codewhisperer" },
|
|
304
|
+
"body": { "profileArn": "{profile}" },
|
|
305
|
+
"resource": "CREDIT",
|
|
306
|
+
"login": ["kiro-cli", "login"],
|
|
307
|
+
"response": "usageBreakdownList[resourceType=CREDIT].currentUsageWithPrecision and .usageLimitWithPrecision; plus subscriptionInfo, overageConfiguration, nextDateReset, daysUntilReset",
|
|
308
|
+
"verified": true
|
|
309
|
+
},
|
|
310
|
+
"api_key_note": "A ksk_ API key is NOT a bearer token for this endpoint — it is rejected with AccessDeniedException on codewhisperer and 'Invalid token' on management.kiro.dev. It authenticates the CLI via KIRO_API_KEY. The CLI's cached OIDC access token is what works here.",
|
|
311
|
+
"fallback": {
|
|
312
|
+
"source": "transcript",
|
|
313
|
+
"reading": "sum",
|
|
314
|
+
"transcripts": "~/.kiro/sessions/*/*/messages.jsonl",
|
|
315
|
+
"note": "Each usage_summary closes one turn and carries that turn's whole cost, so the records add up. Measured on one machine's store, July to September 2026: 455 records and never two for one turn, no request id shared by two consecutive records, and the older records that carry no request ids never two for one turn either. The peak-per-turn reading declared here before took a drop between two records for a new turn and read 79% of the sum; each session's last record alone reads under 1% of it.",
|
|
316
|
+
"accuracy": "a floor: sessions on other machines are invisible. The 69% of the account figure recorded here was measured under the peak-per-turn reading; the sum has not been measured against the account."
|
|
317
|
+
}
|
|
318
|
+
},
|
|
319
|
+
"quota": {
|
|
320
|
+
"stops": [
|
|
321
|
+
{ "words": "reached your overage limit[^\\n]*", "hours": 744 },
|
|
322
|
+
{ "words": "reached your monthly usage limit[^\\n]*", "hours": 744 },
|
|
323
|
+
{ "words": "ServiceQuotaExceededException[^\\n]*", "hours": 744 }
|
|
324
|
+
],
|
|
325
|
+
"stops_note": "The words a turn ends on when the account's credits stop it: the error a headless run prints as it exits, and the displayError the session store keeps (a session_metadata record, value.errorType OverageLimitReachedError or UsageLimitReachedError). Read on one machine's session store: 32 overage stops, You've reached your overage limit. (Request ID: <id>), and 7 monthly ones, You've reached your monthly usage limit. Please return next month to continue building. (Request ID: <id>); a nudge that hit the overage limit printed a ServiceQuotaExceededException line before it. Neither names a reset: the credits come back at the month's reset (billing.reset_day) or when a person raises the overage limit. The hours above are the longest such wait - an unchecked 744 h = 31 days, the longest run from one reset_day to the next (e.g. 1 January to 1 February), so a parked slice is never held past a reset it could act on and the watchdog retries in between (watchdog.quota_retry_hours, 5 h default, when no reset is named). The store keeps the stop in a record that is neither a prompt nor a reply, which the transcript reading does not read; the nudge that dies on it is read."
|
|
326
|
+
},
|
|
327
|
+
"models": {
|
|
328
|
+
"default": null,
|
|
329
|
+
"review": null,
|
|
330
|
+
"_note": "Kiro picks its own model; --model passes one through when set"
|
|
331
|
+
}
|
|
332
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "ollama",
|
|
3
|
+
"name": "Ollama (local models)",
|
|
4
|
+
"verified": "untested",
|
|
5
|
+
"options": { "trust_none": null, "trust_none_why": "a model backend, not an agent CLI: an agent adapter pointed at it holds the role" },
|
|
6
|
+
"kind": "model-backend",
|
|
7
|
+
"notes": "Not a coding agent. Ollama serves models; an agent adapter points at it. Listed here so a role can be assigned a local model by name, and because the economics differ enough to change which roles are worth running: no quota, no per-token cost, no network — but a smaller model and a shorter context.",
|
|
8
|
+
"detect": { "headless": [] },
|
|
9
|
+
"serve": { "argv": ["ollama", "serve"], "default_endpoint": "http://127.0.0.1:11434" },
|
|
10
|
+
"list_models": { "argv": ["ollama", "list"] },
|
|
11
|
+
"hosts": {
|
|
12
|
+
"note": "Agents that can be pointed at an Ollama endpoint instead of a hosted provider.",
|
|
13
|
+
"opencode": "provider config; installed on this machine",
|
|
14
|
+
"aider": "--model ollama/<model>",
|
|
15
|
+
"continue": "config.json models[].provider = ollama"
|
|
16
|
+
},
|
|
17
|
+
"good_for": [
|
|
18
|
+
"normalising tracker items into the inbox schema",
|
|
19
|
+
"deduplicating and clustering issues",
|
|
20
|
+
"classifying an item's shape (slice vs project) as a first pass",
|
|
21
|
+
"summarising a transcript for a status line"
|
|
22
|
+
],
|
|
23
|
+
"not_for": [
|
|
24
|
+
"writing acceptance boundaries — admission is a judgement call and the whole gate",
|
|
25
|
+
"implementing slices against a spec",
|
|
26
|
+
"reviewing another agent's work"
|
|
27
|
+
],
|
|
28
|
+
"why": "The cheap roles are high-volume and low-stakes: fifty issues normalised into one schema costs a frontier model real quota and asks nothing a local model cannot do. The expensive roles are the opposite — one decision, and being wrong is costly. Splitting them is what makes an unattended queue affordable."
|
|
29
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
{
|
|
2
|
+
"project_config": [".omp", "AGENTS.md", "CLAUDE.md"],
|
|
3
|
+
"id": "omp", "name": "oh-my-pi", "contract": 1, "verified": "untested",
|
|
4
|
+
"disclaimer": "Written from the documented interface, not verified against an install. Flags drift; correct and open a PR.",
|
|
5
|
+
"notes": "A pi fork (can1357/oh-my-pi, npm @oh-my-pi/pi-coding-agent). Its default approval mode is already yolo. --plan <id> chooses the model of the plan role; it is not a plan mode.",
|
|
6
|
+
"sources": ["https://github.com/can1357/oh-my-pi/blob/main/docs/cli-reference.md",
|
|
7
|
+
"https://github.com/can1357/oh-my-pi/blob/main/docs/approval-mode.md",
|
|
8
|
+
"https://github.com/can1357/oh-my-pi/blob/main/docs/session.md",
|
|
9
|
+
"https://github.com/can1357/oh-my-pi/blob/main/docs/context-files.md"],
|
|
10
|
+
"detect": { "headless": ["-p"] },
|
|
11
|
+
"send": { "argv": ["omp", "-p", "{prompt}"], "cwd_matters": true,
|
|
12
|
+
"stdin": { "replaces": ["{prompt}"], "with": [],
|
|
13
|
+
"note": "Verified from the CLI reference (github.com/can1357/oh-my-pi, docs/cli-reference.md), read 2026-09-17: non-TTY stdin is read automatically as the initial prompt, with no - marker." } },
|
|
14
|
+
"resume": { "argv": ["omp", "--resume", "{session}", "-p", "{prompt}"], "continue_last": ["omp", "--continue", "-p", "{prompt}"],
|
|
15
|
+
"note": "--resume takes an id prefix or a path",
|
|
16
|
+
"stdin": { "replaces": ["{prompt}"], "with": [], "note": "As send: the reference says it of every run." } },
|
|
17
|
+
"options": {
|
|
18
|
+
"trust_none": ["--no-tools"],
|
|
19
|
+
"trust_none_note": "every built-in tool off",
|
|
20
|
+
"model": ["--model", "{model}"],
|
|
21
|
+
"effort": ["--thinking", "{effort}"],
|
|
22
|
+
"effort_values": ["off", "minimal", "low", "medium", "high", "xhigh", "max", "auto"],
|
|
23
|
+
"output_json": ["--mode", "json"],
|
|
24
|
+
"trust_all": ["--approval-mode", "yolo"],
|
|
25
|
+
"bypass": {
|
|
26
|
+
"--approval-mode yolo": { "roles": ["implementer"],
|
|
27
|
+
"why": "Kept, and leaving it out narrows nothing: yolo is omp's default approval mode. --approval-mode write approves reads and edits and fails every shell command no one can approve, so an implementer could run none of its gates without bash.patterns allow rules in a configuration overlay polyctl does not write. Read on 2026-09-17 from github.com/can1357/oh-my-pi (docs/approval-mode.md, docs/cli-reference.md, src/extensibility/extensions/wrapper.ts)." }
|
|
28
|
+
}
|
|
29
|
+
},
|
|
30
|
+
"transcript": { "kind": "jsonl", "path": "~/.omp/agent/sessions/{encoded_cwd}/*_{session}.jsonl", "todo": "confirm the cwd encoding and the record shape against an install" },
|
|
31
|
+
"busy": { "mtime_glob": "~/.omp/agent/sessions/*/*.jsonl", "idle_seconds": 240 },
|
|
32
|
+
"directives": { "steering_files": [".omp/AGENTS.md", ".omp/RULES.md", "AGENTS.md", "CLAUDE.md", "~/.omp/agent/AGENTS.md"],
|
|
33
|
+
"note": "also reads other harnesses' rule files; --no-rules loads none" }
|
|
34
|
+
}
|