Üšé ŵîţĥ Çļàüđé

Àñ àššîšţàñţ çöññéçţéđ ţö à ķàþî þŕöĵéçţ ŵŕîţéš ţö ţĥé þŕöĵéçţ'š ŕüļéš. Îţ ŕéàđš ţĥé ţéŕḿš àñđ ṽöîçé ţĥàţ àþþļý ţö à ƒîļé ƃéƒöŕé îţ ŵŕîţéš, çĥéçķš éàçĥ ƒîļé îţ çĥàñĝéš, àñđ ñöţéš ŵĥàţ îţ šééš ƒöŕ à þéŕšöñ ţö đéçîđé àƃöüţ. Çöññéçţ öñé ŵîţĥ Çöññéçţ öñ ţĥé Àššîšţàñţš þàĝé îñ Ķàþî Đéšķţöþ, öŕ ŕüñ kapi connect îñ ţĥé þŕöĵéçţ'š ƒöļđéŕ. Ƃöţĥ ŵŕîţé ţĥé šàḿé ƒîļéš.

ķàþî çàñ àļšö ŕüñ Çļàüđé îţšéļƒ, ţĥŕöüĝĥ ýöüŕ Çļàüđé Çöđé šîĝñ-îñ; šéé Ļéţ ķàþî ŕüñ Çļàüđé.

Çöññéçţ àñ àššîšţàñţ

$ kapi connect
Claude Code   connected · rules, MCP server, skill
  .mcp.json            created
  .claude/skills/kapi  created
  Edit hook            pending: in Claude Code, /plugin marketplace add neokapi/claude-plugins, then /plugin install kapi@neokapi-plugins
  Stop hook            pending: in Claude Code, /plugin marketplace add neokapi/claude-plugins, then /plugin install kapi@neokapi-plugins
Cursor        connected · rules, MCP server
  .cursor/mcp.json     created
VS Code       not connected: no .vscode/ folder here (kapi connect vscode adds it)
Codex         not connected: no .codex/ folder here (kapi connect codex adds it)

Project
  kapi.yaml            created
  AGENTS.md            created
  CLAUDE.md            updated (Writing rules section)

See what an assistant reads for a file: kapi context <path> --explain

Ţĥàţ ŕüñ ŵàš îñ à ƒöļđéŕ ŵîţĥ à .cursor/ đîŕéçţöŕý, à CLAUDE.md öƒ îţš öŵñ àñđ ñö ŕéçîþé. kapi connect çöññéçţš Çļàüđé Çöđé àñđ éàçĥ àššîšţàñţ ŵĥöšé ƒöļđéŕ ţĥé þŕöĵéçţ ķééþš, àñđ ļîšţš ţĥé öţĥéŕš. Éàçĥ ļîñé šàýš ŵĥàţ ĥàþþéñéđ: çŕéàţéđ, üþđàţéđ öŕ ķéþţ ƒöŕ à ƒîļé; đéļéţéđ, öŕ ŕéḿöṽéđ ţĥé šéçţîöñ, ƒöŕ à ŕüļéš ƒîļé îñ à ƒöļđéŕ ţĥàţ ĥàš ñö ŕüļéš öƒ îţš öŵñ àñý ḿöŕé. À ƒöļđéŕ ŵîţĥ ñö ŕéçîþé ĝéţš ţĥé öñé kapi init ŵŕîţéš. À šéçöñđ ŕüñ ķééþš éṽéŕý ƒîļé àš îţ îš.

kapi connect --dry-run ļîšţš ţĥé šàḿé ƒîļéš ŵîţĥ ŵĥàţ îţ ŵöüļđ đö, àñđ ŵŕîţéš ñöñé öƒ ţĥéḿ.
kapi connect codex çöññéçţš öñé àššîšţàñţ: claude, cursor, vscode, codex öŕ agents. Àñý öţĥéŕ ñàḿé éẋîţš ŵîţĥ šţàţüš 1 àñđ ļîšţš ţĥéšé.
kapi connect --json ĝîṽéš ţĥé àššîšţàñţš àñđ ţĥé ƒîļéš àš đàţà.

kapi init ŵŕîţéš ţĥé šàḿé ƒîļéš ŵĥéñ îţ çŕéàţéš à þŕöĵéçţ, šö à þŕöĵéçţ ḿàđé ŵîţĥ kapi init îš àļŕéàđý çöññéçţéđ ţö Çļàüđé Çöđé. Ŕüñ kapi connect îñ à þŕöĵéçţ àñ éàŕļîéŕ ķàþî çŕéàţéđ ţö ƃŕîñĝ îţš ŵîŕîñĝ üþ ţö đàţé.

Ŵĥéñ ţĥé àššîšţàñţ ŕéàđš ţĥé ŕüļéš

Àñ àššîšţàñţ öñ à ķàþî þŕöĵéçţ ḿééţš ţĥé ŕüļéš àš îţ šţàŕţš, ƃéƒöŕé îţ ŵŕîţéš àñđ àƒţéŕ îţ éđîţš.

Àš îţ šţàŕţš, îţ ŕéàđš ţĥé Ŵŕîţîñĝ ŕüļéš šéçţîöñ öƒ CLAUDE.md, ţĥé ƒîļé Çļàüđé Çöđé ŕéàđš, öŕ öƒ AGENTS.md, ŵĥîçĥ ḿöšţ öţĥéŕ àĝéñţš ŕéàđ: ţĥé ṽöîçé, ŵĥàţ ţö ŵŕîţé àñđ ŵĥàţ ñöţ, àñđ ţĥé kapi check ļîñé. À ƒöļđéŕ ŵĥöšé ŕüļéš đîƒƒéŕ ƒŕöḿ ţĥé ŕööţ'š ĝéţš ƒîļéš öƒ îţš öŵñ, šö à ŕéñàḿé ķéþţ ƒöŕ help/ îš šţàţéđ îñ help/CLAUDE.md, àñđ api/CLAUDE.md šàýš ţĥé öļđ ñàḿé îš çöŕŕéçţ ţĥéŕé. ķàþî ŕéŵŕîţéš ţĥé šéçţîöñ ŵĥéñ ţĥé ŕüļéš çĥàñĝé àñđ ļéàṽéš ţĥé ŕéšţ öƒ éàçĥ ƒîļé àš ýöü ŵŕöţé îţ; à CLAUDE.md ţĥàţ îḿþöŕţš @AGENTS.md ĝéţš ñö šéçţîöñ öƒ îţš öŵñ. Šéé ŕüļéš ƒîļéš ƒöŕ àĝéñţš.

Ƃéƒöŕé îţ ŵŕîţéš à ƒîļé ţĥé šéçţîöñ đöéš ñöţ çöṽéŕ, îţ àšķš kapi context <path>, öŕ context_read ţĥŕöüĝĥ ţĥé ḾÇÞ šéŕṽéŕ. kapi context <path> --explain þŕîñţš ŵĥàţ îţ ŕéàđš ţĥéŕé.

Àƒţéŕ îţ éđîţš, îţ ŕüñš kapi check öñ éàçĥ ƒîļé îţ çĥàñĝéđ, öŕ check_file, àñđ ƒîẋéš ŵĥàţ ƒàîļš. Ţĥé ķàþî Çļàüđé Çöđé þļüĝîñ ḿàķéš ƃöţĥ çĥéçķš àüţöḿàţîç:

Ţĥé éđîţ ĥööķ ŕüñš àƒţéŕ éàçĥ éđîţ àñđ çĥéçķš ţĥé öñé ƒîļé ţĥé éđîţ ŵŕöţé, àš kapi check <file> đöéš. À ƒàîļîñĝ ƒîñđîñĝ (à ñàḿé, à šþéļļîñĝ, à ŵöŕđ ŕüļé) çöḿéš ƃàçķ ţö Çļàüđé ƃéšîđé ţĥé éđîţ'š ŕéšüļţ, ŵîţĥ ţĥé ƒîẋ ŵĥéñ ţĥé ŕüļé ñàḿéš öñé, šö Çļàüđé çöŕŕéçţš ţĥé ƒîļé ƃéƒöŕé îţ ŕéþöŕţš đöñé.
Ţĥé Šţöþ ĥööķ ŕüñš ţĥé þŕöĵéçţ ĝàţé (kapi check --ship) ŵĥéñ Çļàüđé ţŕîéš ţö ƒîñîšĥ, àñđ ķééþš îţ ŵöŕķîñĝ ŵĥîļé à ĝàţé ƒàîļš.

kapi connect ŕéþöŕţš ƃöţĥ ĥööķš àš þéñđîñĝ üñţîļ ţĥé þļüĝîñ îš îñšţàļļéđ àñđ éñàƃļéđ, ŵîţĥ ţĥé ţŵö çöḿḿàñđš ţĥàţ îñšţàļļ îţ.

Àš îţ ŵöŕķš, ţĥé àššîšţàñţ ñöţéš ŵĥàţ ţĥé ƒîļéš ķééþ ţö àñđ ŵĥàţ ýöü çĥàñĝé îñ îţš đŕàƒţš, ŵîţĥ ţĥé ƒîļé àñđ šéñţéñçé éàçĥ çàḿé ƒŕöḿ. Éàçĥ ñöţé àŕŕîṽéš àš à šüĝĝéšţîöñ: çĥéçķš ŕéþöŕţ îţ àñđ ñöñé ƒàîļš öñ îţ üñţîļ ýöü ķééþ îţ ŵîţĥ kapi rules. À ñöţé ĥöļđš öñļý îñ ţĥé ƒîļéš ŵĥéŕé ţĥé àššîšţàñţ šàŵ îţ üñţîļ ýöü ŵîđéñ îţ. Šéé Ĝŕöŵîñĝ çöñţéẋţ.

Ŵĥàţ `kapi connect` ŵŕîţéš

Àĝéñţ	Ŵĥàţ îţ ĝéţš
Çļàüđé Çöđé	`.mcp.json` ŵîţĥ ţĥé `kapi` šéŕṽéŕ, àñđ ţĥé ķàþî šķîļļ îñ `.claude/skills/kapi/SKILL.md`
Çüŕšöŕ	`.cursor/mcp.json` ŵîţĥ ţĥé `kapi` šéŕṽéŕ
ṼŠ Çöđé	`.vscode/mcp.json` ŵîţĥ ţĥé `kapi` šéŕṽéŕ
Çöđéẋ	`.codex/config.toml` ŵîţĥ ţĥé `kapi` šéŕṽéŕ, ŕéàđ öñçé ýöü ţŕüšţ ţĥé ŕéþöšîţöŕý
Àñý ŠĶÎĻĻ.ḿđ-àŵàŕé ţööļ	ţĥé ķàþî šķîļļ îñ `.agents/skills/kapi/SKILL.md`

Éṽéŕý àĝéñţ àļšö ĝéţš ţĥé ŕüļéš ƒîļéš. Ţĥé šķîļļ šàýš ĥöŵ ţö ŕéàđ ŵĥàţ àþþļîéš ţö à ƒîļé, ñöţé ŵĥàţ îţ šééš àñđ ŵĥàţ ýöü çĥàñĝé, çĥéçķ éđîţš, àñđ ŕéþöŕţ ţĥé šéššîöñ, ŵîţĥ ţĥé ÇĻÎ àñđ ḾÇÞ ƒöŕḿ öƒ éàçĥ. kapi help <topic> þŕîñţš ţĥé ļöñĝéŕ ĝüîđéš ƒŕöḿ ýöüŕ îñšţàļļéđ ƃîñàŕý.

Çļàüđé Çöđé îš ŵîŕéđ éṽéŕý ţîḿé. Ţĥé öţĥéŕš àŕé ŵîŕéđ ŵĥéñ ţĥé þŕöĵéçţ àļŕéàđý ķééþš ţĥéîŕ đîŕéçţöŕý, šö ñéîţĥéŕ çöḿḿàñđ àđđš à đîŕéçţöŕý ƒöŕ àñ éđîţöŕ ýöü đö ñöţ üšé. Ñàḿé öñé ŵîţĥ kapi connect <assistant>, öŕ çĥööšé ŵîţĥ kapi init --agents:

kapi init --agents claude-code,cursor   # exactly these
kapi init --agents all                  # every agent kapi knows
kapi init --agents none                 # write no agent configuration

kapi init --no-rules-files ļéàṽéš öüţ ţĥé ŕüļéš ƒîļéš.

Éṽéŕýţĥîñĝ îţ ŵŕîţéš îš îñšîđé ţĥé þŕöĵéçţ. Ţĥé ḾÇÞ éñţŕý ĥöļđš à çöḿḿàñđ öñļý, ŵîţĥ ñö šĥéļļ, éñṽîŕöñḿéñţ öŕ çŕéđéñţîàļ. Àñ éñţŕý çàļļéđ kapi ţĥàţ ýöü ŵŕöţé öŕ çĥàñĝéđ îš ļéƒţ éẋàçţļý àš îţ îš. Àñ éñţŕý éẋàçţļý àš ķàþî ŵŕöţé îţ ƒöļļöŵš ţĥé ŕéçîþé, šö àƒţéŕ ýöü àđđ ţàŕĝéţ ļàñĝüàĝéš, ŕüññîñĝ kapi connect àĝàîñ àđđš ţĥé ţŕàñšļàţîöñ ţööļš. À šķîļļ đîŕéçţöŕý àñ éàŕļîéŕ ķàþî ƒîļļéđ ŵîţĥ ŕéƒéŕéñçé ƒîļéš îš çļéàŕéđ öƒ ţĥé ƒîļéš ķàþî ŵŕöţé ţĥéŕé, àñđ àñý ƒîļé öƒ ýöüŕš îñ îţ šţàýš.

Çļàüđé Çöđé àšķš ýöü ţö àþþŕöṽé à þŕöĵéçţ ḾÇÞ šéŕṽéŕ ţĥé ƒîŕšţ ţîḿé ýöü öþéñ ţĥé þŕöĵéçţ, šö ŕéṽîéŵ .mcp.json ƃéƒöŕé ýöü šàý ýéš, ţĥé ŵàý ýöü ŵöüļđ àñý ƒîļé à ŕéþöšîţöŕý šĥîþš.

Šéţ îţ üþ ƃý ĥàñđ

Ţĥéšé àŕé ţĥé þîéçéš kapi connect ŵŕîţéš, ƒöŕ à çļîéñţ îţ đöéš ñöţ çöñƒîĝüŕé öŕ à šéţüþ ýöü ŵàñţ ţö çöñţŕöļ ýöüŕšéļƒ. Àļļ öƒ ţĥéḿ ñééđ kapi öñ ýöüŕ PATH (îñšţàļļàţîöñ), àñđ ñöñé ñééđš à þŕöṽîđéŕ çŕéđéñţîàļ ƒöŕ àţţéñđéđ ŵöŕķ: Çļàüđé ŵŕîţéš, ķàþî àþþļîéš àñđ çĥéçķš.

Ýöü ŵöŕķ îñ…	Üšé	Ĥöŵ îţ ŕéàçĥéš ķàþî
Çĥàţ (Çļàüđé Çöđé, þļàîñ-ļàñĝüàĝé þŕöḿþţš)	ţĥé Àĝéñţ Šķîļļ (`SKILL.md`)	Çļàüđé ŕüñš `kapi` çöḿḿàñđš îţšéļƒ àñđ ļööþš üñţîļ ţĥé çĥéçķš þàšš
ÎĐÉ (Çļàüđé Đéšķţöþ, Çüŕšöŕ, Ŵîñđšüŕƒ, ṼŠ Çöđé)	ţĥé ḾÇÞ šéŕṽéŕ (`kapi mcp`)	`context_read` ƒöŕ à ƒîļé ţĥé ŕüļéš ƒîļéš đö ñöţ çöṽéŕ, `context_note` ƒöŕ ŵĥàţ îţ ñöţîçéš, àñđ `check_file`; `--tools` àđđš ḿöŕé šéţš
ÇÎ (ñö àššîšţàñţ îñ ţĥé ļööþ)	ţĥé ÇĻÎ đîŕéçţļý	`kapi check` / `kapi check --ship` éẋîţ ñöñ-žéŕö, ƒàîļîñĝ ţĥé ƃüîļđ

Îñšţàļļ ţĥé Àĝéñţ Šķîļļ (Çļàüđé Çöđé àñđ àñý ŠĶÎĻĻ.ḿđ-àŵàŕé ţööļ)

Çļàüđé Çöđé: ţĥé þļüĝîñ ƃüñđļéš ţĥé šķîļļ, ţĥé éđîţ ĥööķ àñđ ţĥé Šţöþ ĥööķ àƃöṽé, àñđ à ÞŕéŢööļÜšé ĥööķ:

/plugin marketplace add neokapi/claude-plugins
/plugin install kapi@neokapi-plugins

Ţĥé ÞŕéŢööļÜšé ĥööķ đéñîéš ĥàñđ-éđîţš ţö ĝéñéŕàţéđ ţŕàñšļàţîöñ ţàŕĝéţš, šţééŕîñĝ çĥàñĝéš ţĥŕöüĝĥ ţĥé šöüŕçé. Éṽéŕý ĥööķ îš ƒàîļ-öþéñ öüţšîđé à þŕöĵéçţ, àñđ àļļ ƒöļļöŵ öñé đéçîšîöñ þŕöţöçöļ. kapi connect ŕéàđš ţĥé þŕöĵéçţ'š .claude/settings.json àñđ .claude/settings.local.json, ţĥéñ ýöüŕ öŵñ Çļàüđé Çöđé šéţţîñĝš (settings.json îñ $CLAUDE_CONFIG_DIR, öŕ îñ ~/.claude), àñđ ŕéþöŕţš ţĥé ĥööķš àš ķéþţ öñçé öñé öƒ ţĥéḿ éñàƃļéš ţĥé þļüĝîñ, öŕ kept (enabled for your user) ŵĥéñ öñļý ýöüŕ öŵñ šéţţîñĝš đö.

Çöþîļöţ, Çüŕšöŕ, Ŵîñđšüŕƒ, ṼŠ Çöđé, Çöđéẋ: SKILL.md îš àñ öþéñ šţàñđàŕđ:

npx skills add neokapi/agent-skills --skill kapi     # add -a <tool> for a specific tool
npx skills update kapi                               # refresh later

Îñšţàļļ ţĥé ḾÇÞ šéŕṽéŕ (Çļàüđé Đéšķţöþ, Çļàüđé Çöđé, Çüŕšöŕ, àñđ ţĥé ŕéšţ)

Ýöüŕ çļîéñţ ļàüñçĥéš kapi mcp àš à šţđîö šüƃþŕöçéšš. Çļàüđé Çöđé àñđ Çüŕšöŕ ŕéàđ ţĥé šéŕṽéŕ ļîšţ üñđéŕ mcpServers; ṼŠ Çöđé ŕéàđš îţ üñđéŕ servers. Çļàüđé Đéšķţöþ üšéš claude_desktop_config.json ŵîţĥ ţĥé šàḿé šĥàþé àš Çļàüđé Çöđé'š:

{
  "mcpServers": {
    "kapi": {
      "type": "stdio",
      "command": "kapi",
      "args": ["mcp", "--project", "kapi.yaml"]
    }
  }
}

--project ñàḿéš ţĥé þŕöĵéçţ ţĥé šéŕṽéŕ àñšŵéŕš ƒöŕ. Ŵîţĥöüţ îţ, ţĥé šéŕṽéŕ ƃîñđš ŵĥîçĥéṽéŕ þŕöĵéçţ šîţš àƃöṽé ţĥé đîŕéçţöŕý ýöüŕ çļîéñţ šţàŕţéđ îţ îñ. Ţĥé ŵŕîţîñĝ ţööļš îñçļüđé read_blocks, apply_edits àñđ describe_format, ŵĥîçĥ ŕéàđ à ƒîļé'š ƃļöçķš, ŵŕîţé éđîţš ƃàçķ ŵîţĥ ţĥé ƒîļé'š šţŕüçţüŕé àñđ îñļîñé çöđéš ķéþţ, àñđ šàý ŵĥàţ à ƒöŕḿàţ šüþþöŕţš. Ƒöŕ à þŕöĵéçţ ţĥàţ đéçļàŕéš ţàŕĝéţ ļàñĝüàĝéš, kapi connect àñđ kapi init àđđ "--tools", "writing,translation" ţö ţĥé àŕĝüḿéñţš, šö ţĥé àĝéñţ àļšö ĝéţš ţĥé ţŕàñšļàţîöñ ţööļš ƃéšîđé ţĥé ŵŕîţîñĝ öñéš.

Šéé ḾÇÞ šéŕṽéŕ ƒöŕ éṽéŕý çļîéñţ'š çöñƒîĝüŕàţîöñ àñđ ţĥé ƒüļļ ţööļ ļîšţ.

Ţĥé ĥööķ đéçîšîöñ þŕöţöçöļ

À ķàþî ĥööķ šţàţéš îţš ṽéŕđîçţ àš ĴŠÖÑ öñ šţđöüţ àñđ àļŵàýš éẋîţš 0. Çļàüđé Çöđé ŕéàđš à ñöñ-žéŕö éẋîţ àš à ƃŕöķéñ ĥööķ, šö à đéñîàļ šéñţ àš àñ éẋîţ çöđé ŵöüļđ çöüñţ àš à ĥööķ éŕŕöŕ àñđ ñöţ ƃé éñƒöŕçéđ. kapi check --ship ķééþš îţš öŵñ ĝàţé éẋîţ çöđé (3) ŵĥéñ ýöü ŕüñ îţ ýöüŕšéļƒ; ţĥé ĥööķ đŕîṽéš ţĥàţ ĝàţé ŵîţĥöüţ ŕéþļàçîñĝ îţ.

Ŵĥàţ ţĥé ĥööķ ƒöüñđ	Öñ šţđöüţ	Ŵĥàţ ĥàþþéñš
Ţĥé éđîţéđ ƒîļé ĥàš à ƒàîļîñĝ ƒîñđîñĝ	`{"decision":"block","reason":"…"}` (ÞöšţŢööļÜšé)	Ţĥé éđîţ šţàñđš. Çļàüđé ŕéàđš ţĥé `reason` ƃéšîđé ţĥé éđîţ'š ŕéšüļţ: öñé ļîñé þéŕ ƒîñđîñĝ, ţĥé ƒîẋ ŵĥéñ ţĥé ŕüļé ñàḿéš öñé, àñđ ţĥé `kapi check <file>` çöḿḿàñđ ţö ŕüñ.
À ĝàţé ƒàîļš / ţĥé ƒîļé îš à ĝéñéŕàţéđ ţàŕĝéţ	`{"decision":"block","reason":"…"}` (Šţöþ) · `{"hookSpecificOutput":{"permissionDecision":"deny","permissionDecisionReason":"…"}}` (ÞŕéŢööļÜšé)	Çļàüđé ķééþš ŵöŕķîñĝ, öŕ ţĥé éđîţ îš ŕéƒüšéđ. Ţĥé `reason` ñàḿéš ţĥé ƒîñđîñĝš, öŕ ţĥé šöüŕçé àñđ ļöçàļé ţö çĥàñĝé îñšţéàđ.
Ñöţĥîñĝ ţö ŕéþöŕţ (ţĥé ƒîļé öŕ ţĥé ĝàţéš þàšš, ţĥé ƒîļé îš ñöţ ĝéñéŕàţéđ öŕ ñöţ ŕéàđ ƃý ţĥé þŕöĵéçţ, öŕ ţĥéŕé îš ñö ķàþî þŕöĵéçţ)	ñöţĥîñĝ	Ţĥé öþéŕàţîöñ þŕöçééđš.
Ţĥé ĝüàŕđ çöüļđ ñöţ ŕüñ àţ àļļ	`{"systemMessage":"…"}` þļüš ţĥé šàḿé ŵàŕñîñĝ öñ šţđéŕŕ, ñàḿîñĝ ţĥé ĥööķ	Ţĥé öþéŕàţîöñ þŕöçééđš: ķàþî ĥööķš ƒàîļ öþéñ, šö à ƃŕöķéñ ĝüàŕđ ñéṽéŕ ƃļöçķš ŵöŕķ. Ţĥé ñöţîçé šţàţéš ţĥé ƃýþàšš, šö ýöü çàñ ţéļļ à ĝüàŕđ ţĥàţ ñéṽéŕ ŕàñ ƒŕöḿ öñé ţĥàţ þàššéđ.

Àñ üñŕéàđàƃļé, éḿþţý, öŕ ḿàļƒöŕḿéđ ĥööķ þàýļöàđ; à šéššîöñ đîŕéçţöŕý ķàþî çàññöţ éñţéŕ; à ŕéçîþé ţĥàţ ŵîļļ ñöţ ļöàđ ƃéçàüšé îţ ñééđš à þļüĝîñ ýöü ĥàṽé ñöţ îñšţàļļéđ: éàçĥ öƒ ţĥöšé ļéàṽéš ţĥé ĝüàŕđ îñšţàļļéđ ƃüţ îñéŕţ. Ţĥé ñöţîçé šàýš ŵĥîçĥ ĥööķ, àñđ ŵĥàţ šţöþþéđ îţ.

Ţĥé ĴŠÖÑ šĥàþéš àŕé Çļàüđé Çöđé'š, àñđ Çļàüđé Çöđé ṽéŕšîöñš îţš öŵñ ĥööķ šçĥéḿà. ķàþî àđđš ñö ṽéŕšîöñ öƒ îţš öŵñ. Ţĥé þöļîçý îñ ţĥé ţàƃļé šţàýš ƒîẋéđ: à ĥööķ ƒàîļš öþéñ àñđ ŕéþöŕţš ţĥé ƃýþàšš.

Ļéţ ķàþî ŕüñ Çļàüđé

Ƒöŕ üñàţţéñđéđ ŕüñš (kapi up àçŕöšš éṽéŕý ļöçàļé, kapi translate ŵîţĥöüţ ýöü îñ ţĥé ļööþ) ķàþî ñééđš à þŕöṽîđéŕ öƒ îţš öŵñ. Îƒ Çļàüđé Çöđé îš šîĝñéđ îñ öñ ýöüŕ ḿàçĥîñé, ţĥàţ þŕöṽîđéŕ çàñ ƃé ýöüŕ Çļàüđé šüƃšçŕîþţîöñ:

kapi models setup     # detects the Claude Code CLI ("uses your Claude subscription"): one confirm, no key

Ýöü ĥàṽé…	Üšé
Çļàüđé Þŕö öŕ Ḿàẋ (Çļàüđé Çöđé îñšţàļļéđ)	`kapi models setup`, àñđ ķàþî ŕüñš Çļàüđé öñ ýöüŕ šüƃšçŕîþţîöñ ŵîţĥ ñö ķéý.
Àñ ÀÞÎ ķéý (Àñţĥŕöþîç, ÖþéñÀÎ, Ĝéḿîñî)	`kapi models setup` ƒîñđš ķéýš àļŕéàđý îñ ýöüŕ éñṽîŕöñḿéñţ, öŕ šţöŕéš öñé îñ ţĥé ÖŠ ķéýçĥàîñ, àñđ ṽéŕîƒîéš îţ ŵîţĥ à ţéšţ çàļļ.
Ñöţĥîñĝ, öŕ öƒƒļîñé	À ļöçàļ ḿöđéļ ṽîà `kapi models ollama`, öŕ Ķàþî Đéšķţöþ'š đéḿö éñĝîñé (îļļüšţŕàţîṽé öüţþüţ, ñö ÀÎ).

Šéţüþ ṽéŕîƒîéš ţĥé çĥöîçé ŵîţĥ à šḿàļļ ţéšţ çàļļ àñđ ŵŕîţéš ţĥé đéƒàüļţ þŕöṽîđéŕ ţö ţĥé ĝļöƃàļ çöñƒîĝ, šĥàŕéđ ŵîţĥ Ķàþî Đéšķţöþ, ŵĥöšé ƒîŕšţ-öþéñ Çöññéçţ ýöüŕ ÀÎ çàŕđ öƒƒéŕš ţĥé šàḿé đéţéçţéđ šîĝñ-îñ àš à öñé-çļîçķ ƃüţţöñ. kapi models list šĥöŵš îţ üñđéŕ Đéţéçţéđ, àļöñĝšîđé Öļļàḿà ḿöđéļš àñđ àñý çļöüđ ķéýš.

Šüƃšçŕîþţîöñ üšé îš ļîḿîţéđ ƃý ýöüŕ Çļàüđé üšàĝé ŵîñđöŵ. À ĥéàṽý ŕüñ ţĥàţ üšéš üþ ţĥé ŵîñđöŵ ĥöļđš ƃàçķ ţĥé ŕéḿàîñđéŕ àñđ ŕéþöŕţš ŵĥéñ îţ ŕéšüḿéš ("Çļàüđé šüƃšçŕîþţîöñ ļîḿîţ ŕéàçĥéđ; ŕéšüḿéš ~7þḿ"). Ţĥé ñéẋţ kapi up þîçķš üþ éẋàçţļý ţĥé ƃļöçķš šţîļļ þéñđîñĝ. Ƒöŕ üñîñţéŕŕüþţéđ ŕüñš, üšé àñ ÀÞÎ ķéý. Šüƃšçŕîþţîöñ àüţĥ îš ƃöüñđ ţö ýöüŕ þéŕšöñàļ šîĝñ-îñ àñđ îţš üšàĝé ŵîñđöŵ, šö ÇÎ šĥöüļđ àļŵàýš üšé à ķéý (à þŕöṽîđéŕ éñṽ ṽàŕ, öŕ kapi credentials add). Šéé Šĥîþ ĝàţéš & ÇÎ.

Ñéẋţ

Çöñţéñţ ĝöṽéŕñàñçé ƒöŕ ÀÎ: ţĥé ĝüàŕđŕàîļš ţĥàţ ḿàķé àĝéñţ öüţþüţ þàšš.
Ƃüļķ ŕéŵŕîţé ŵîţĥ àñ àĝéñţ: à ŕéþö-ŵîđé šŵééþ, ĝàţéđ.
Çĥööšé à ḿöđéļ: éṽéŕý þŕöṽîđéŕ ķàþî çàñ ŕüñ.

Çöññéçţ àñ àššîšţàñţ​

Ŵĥéñ ţĥé àššîšţàñţ ŕéàđš ţĥé ŕüļéš​

Ŵĥàţ kapi connect ŵŕîţéš​

Šéţ îţ üþ ƃý ĥàñđ​

Ţĥé ĥööķ đéçîšîöñ þŕöţöçöļ​

Ļéţ ķàþî ŕüñ Çļàüđé​

Ñéẋţ​