Skip to main content

AI Assistants

CLI assistants share operating rules, skills, read-only review profiles, and local memory tools. Agents work inline by default and query memory on demand. OMP's native advisor adds main-session notes; child advisors stay off.

What is installedโ€‹

PieceSourceDeployed toPage
Global instructionshome/readonly_AGENTS.md~/AGENTS.md, linked into every harnessInstructions
Skillshome/exact_dot_agents/exact_skills/~/.agents/skills/Skills
Subagent profilesk-agent-reviewer (Claude, Pi, OMP), k-agent-scout (Pi)each harness's agents dirSubagents
Knowledge base,ai-kb~/bin/,ai-kb, data in ~/.local/share/ai-kbMemory and handoffs
Session handoffs,handoff~/bin/,handoff, notes in ~/.local/share/agent-handoffsMemory and handoffs
Behavior maps,behavior-map~/bin/,behavior-map, maps in ~/.local/share/k-ai-behavior-mapMemory and handoffs
Intent cards,task and the intent-guard hooks~/bin/,task, cards in ~/.local/share/agent-tasksStaying on the goal
MCP servershome/.chezmoidata/mcp_servers.yamlrendered per harnessMCP servers
Harness configsper-harness files under home/~/.claude, ~/.pi, ~/.omp, ~/.codex, โ€ฆTool configs
Local inferencellama.cpp router and launchers~/bin/,llama-cpp, ,*-llama-cppllama.cpp

Harnessesโ€‹

HarnessDefault modelNotes
Claude Codeclaude-opus-5-5, effort medium,claude-openrouter and ,claude-llama-cpp switch the backend
Piopenai-codex/gpt-6.1-solpi-subagents with built-in agents disabled; repo profiles only
OMPanthropic/claude-opus-5-5:mediumnative scout; repo k-agent-reviewer
Codexgpt-6.1-sol,codex, ,codex-openrouter, ,codex-llama-cpp
OpenCode, Crush, freebuffper-harness configbasic config and MCP; OpenCode also runs the intent-guard plugin

Principlesโ€‹

The global operating rules define the exact scope, approval, verification, and completion gates. Review and verification describes the review loop, including returned findings and review baselines.

  • Inline by default. Subagents handle broad read-only searches and independent reviews. Reviews required by a risky code or instruction change use two fresh reviewers in parallel.

  • Static verification. Run affected unit and static checks once on the finished change, under time limits. Use source reads and isolated local runs for evidence. Live checks require the user's request, a hard timeout, and a copy when they would change external state or overwrite user data.

  • Fix before finishing. Resolve every supported issue in the request's scope and every defect in the change's impact, including low-severity findings. Review fixes and continue until a full review round is clean. Before reporting, finish every doable step in scope or the change's impact, and cleanup; then report evidence, assumptions, proposals, and blockers.

  • On-demand memory. ,ai-kb search when it can help; ,ai-kb remember only for verified, reusable gotchas, or --supersedes to retire a stale capsule.

  • Intent card. Before its first edit the agent writes the task's goal, reading, Done when items, and scope; hooks in every harness check each iteration against it (Staying on the goal).

  • Explicit handoffs. "handoff X" writes a short note with ,handoff; "continue X" reads it in any harness.

  • Behavior maps. Each repo keeps a short map of critical behaviors seen from the user side; agents update only the entries their diff touches.

Related: Reviewing agent diffs.