Šķîþ ţö ḿàîñ çöñţéñţ

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

kapi àñđ Çļàüđé çöññéçţ îñ ţŵö đîŕéçţîöñš. Îñ öñé, ýöü ŵöŕķ îñ Çļàüđé àñđ îţ đŕîṽéš kapi: ţĥé àššîšţàñţ ŵŕîţéš àñđ ţŕàñšļàţéš îñšîđé kapi'š ĝüàŕđŕàîļš. Îñ ţĥé öţĥéŕ, kapi ŕüñš Çļàüđé: ýöüŕ ļöçàļ Çļàüđé Çöđé šîĝñ-îñ ƃéçöḿéš kapi'š ÀÎ þŕöṽîđéŕ, šö kapi up àñđ kapi translate ŕüñ öñ ýöüŕ Çļàüđé šüƃšçŕîþţîöñ ŵîţĥ ñö ÀÞÎ ķéý. Šţàŕţ ƒŕöḿ ŵĥàţ ýöü ĥàṽé:

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

Ŵöŕķ îñ Çļàüđé​

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

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

Çļàüđé Çöđé: ţĥé þļüĝîñ ƃüñđļéš ţĥé šķîļļ þļüš ţŵö ĥööķš:

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

Ţĥé Šţöþ ĥööķ ŕüñš ţĥé þŕöĵéçţ ĝàţé (kapi check --ship) ŵĥéñ Çļàüđé ţŕîéš ţö ƒîñîšĥ àñđ ķééþš îţ ŵöŕķîñĝ ŵĥîļé à ĝàţé ƒàîļš; ţĥé ÞŕéŢööļÜšé ĥööķ đéñîéš ĥàñđ-éđîţš ţö ĝéñéŕàţéđ ţŕàñšļàţîöñ ţàŕĝéţš, šţééŕîñĝ çĥàñĝéš ţĥŕöüĝĥ ţĥé šöüŕçé. Ƃöţĥ àŕé ƒàîļ-öþéñ öüţšîđé à þŕöĵéçţ, àñđ ƃöţĥ ƒöļļöŵ öñé đéçîšîöñ þŕöţöçöļ.

Çöþîļöţ, Çüŕšöŕ, Ŵîñđšüŕƒ, ṼŠ Çöđé, Çöđéẋ: 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 àš à šţđîö šüƃþŕöçéšš. Ƒöŕ Çļàüđé Çöđé, àđđ .mcp.json àţ ţĥé ŕéþöšîţöŕý ŕööţ (Çļàüđé Đéšķţöþ üšéš claude_desktop_config.json, Çöþîļöţ .vscode/mcp.json; šàḿé šĥàþé):

{
  "mcpServers": {
    "kapi": { "command": "kapi", "args": ["mcp"] }
  }
}

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

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

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

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

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

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

Ţĥé ļööþ, ŵĥîçĥéṽéŕ đööŕ: Çļàüđé þüļļš ýöüŕ ṽöîçé ĝüîđé àñđ àþþŕöṽéđ ţéŕḿš ƒîŕšţ (kapi voice guide, kapi terms lookup), ŵŕîţéš ţĥŕöüĝĥ ţĥé öñé ŵŕîţé ṽéŕƃ (kapi apply: šţŕüçţüŕé þŕéšéŕṽéđ, đŕîƒţ-ĝüàŕđéđ ƃý çöñţéñţ ĥàšĥ), ţĥéñ ĝàţéš öüţ ŵîţĥ kapi check üñţîļ ĝŕééñ. Ƃîñđ ţĥé þŕöƒîļé àñđ ţĥé ţéŕḿš šţöŕé îñ à þŕöĵéçţ àñđ ţĥîš ĥàþþéñš àüţöḿàţîçàļļý; ýöüŕ þŕöḿþţš šţàý šĥöŕţ: "Šéţ kapi üþ ƒöŕ ţĥîš þŕöĵéçţ", "Çĥéçķ README.md àĝàîñšţ öüŕ ṽöîçé þŕöƒîļé àñđ ƒîẋ ŵĥàţ ƒàîļš", "Ţŕàñšļàţé ţĥé đöçš îñţö Ƒŕéñçĥ àñđ Ĝéŕḿàñ, ţĥéñ ƃŕîñĝ ţĥéḿ ţö ţĥé šĥîþ ĝàţé".

Ţĥé þŕöĵéçţ àļšö ţéļļš ţĥé àššîšţàñţ îţ ĥàš à ṽöîçé. kapi init ŵŕîţéš à šĥöŕţ šéçţîöñ îñţö CLAUDE.md, ţĥé ƒîļé Çļàüđé Çöđé ŕéàđš, ñàḿîñĝ ţĥé ṽöîçé àñđ ţĥé çöḿḿàñđ ţĥàţ ŕéţŕîéṽéš îţ, àñđ kapi voice pointer ŵŕîţéš öŕ ŕéƒŕéšĥéš îţ öñ à þŕöĵéçţ ţĥàţ ƃöüñđ îţš ṽöîçé ļàţéŕ. À ŕööţ ţĥàţ ĥöļđš AGENTS.md àļöñé ķééþš ţĥé šéçţîöñ ţĥéŕé, àñđ à ļîñé ŕéàđîñĝ @AGENTS.md îñ à CLAUDE.md îḿþöŕţš îţ. Ţĥé šéçţîöñ çàŕŕîéš ñö ĝüîđàñçé öƒ îţš öŵñ, šö à çĥàñĝéđ þŕöƒîļé ñéṽéŕ ļéàṽéš îţ šţàļé.

Ļéţ kapi ŕüñ Çļàüđé​

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

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

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

Ñéẋţ​