Agent kinds
Built-in agent personas spawned via /agent <kind> <prompt> — the four non-judge kinds ship as markdown in the kcode-essentials content bundle (materialized to ~/.kcode/plugins-builtin/ at boot and loaded first; judge stays compiled-in for judge-orchestration).
Full notes from the app
Each kind comes with its own system prompt, tool whitelist, and permission posture. User-authored kinds in ~/.kcode/agents/*.md (or <project>/.kcode/agents/*.md) additionally accept optional model (a full model id like claude-opus-4-8 or a display label like Claude Opus 4.8, resolved to an id when the kind is spawned) and effort (minimal/low/medium/high) frontmatter to pin the model + reasoning effort per kind; omit either to inherit the session's model / the default effort. Plugin bundles can ship kinds too (<plugin>/agents/*.md, same frontmatter) — they load last, so a builtin/user/project name always wins a collision, and a plugin blocklisted in <project>/.kcode/policy.toml contributes none.
6 entries · kcode 0.4.0
| Kind | Tools | Permission | What it does |
|---|---|---|---|
| general | fs_read fs_write bash | Default | General-purpose coding agent. Full read/write/exec. The default kind. |
| planner | fs_read | Plan | Read-only planning agent. Reads code, drafts plans, writes nothing. |
| researcher | fs_read grep web_fetch | Plan | Read-only investigator. Adds grep and web_fetch over planner for deeper research. |
| security-reviewer | fs_read grep | Plan | Audits code for security issues without modifying. Refuses any write or exec. |
| judge | emit_judge_verdict | Plan | Round-end arbiter, off by default — opt in with judge_orchestration.enabled = true. Decides whether the parent agent should continue or stop after a round. It reads a snapshot of the round — your request for the turn, the tools the agent used, and its last reply — not the conversation itself. See continuation rule 9. |
| System prompt override | The built-in system prompt is assembled from per-section markdown files compiled into the binary (libs/context/prompt/*.md: identity, tools, style, rich-output, memory, recall, control-plane). Drop a file at ~/.kcode/prompt/<section>.md to override that one section globally — no recompile; the rest keep their compiled-in defaults, and a blank/absent file falls back to the default. Global-only by design (2026-08-31): there is no per-project override, so a repo can't silently reshape the agent's base behaviour. |