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

Ĝöàļ: þüţ ţĥé àššîšţàñţ ýöü ŵŕîţé ŵîţĥ öñ à þŕöĵéçţ, šö îţ ƒöļļöŵš ţĥé þŕöĵéçţ'š ŕüļéš àñđ ļéàṽéš ŵĥàţ îţ ñöţîçéš ƒöŕ ýöü ţö ŕéṽîéŵ. Ýöü đö ţĥîš öñçé þéŕ þŕöĵéçţ àñđ àššîšţàñţ, öñ ţĥé þŕöĵéçţ'š Àššîšţàñţš þàĝé, ŵîţĥ ñö ţéŕḿîñàļ.

Ţĥé Àššîšţàñţš þàĝé

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

Àššîšţàñţš ĥàš à ŕöŵ ƒöŕ éàçĥ àššîšţàñţ: Çļàüđé Çöđé, Çüŕšöŕ, ṼŠ Çöđé, Çöđéẋ, Àĝéñţ šķîļļš, àñđ Çļàüđé Đéšķţöþ öñ ḿàçÖŠ àñđ Ŵîñđöŵš. Éàçĥ ŕöŵ šĥöŵš ţĥé àššîšţàñţ'š ḿàŕķ àñđ öñé öƒ ţŵö šţàţéš:

• Ñöţ çöññéçţéđ, ŵîţĥ Çöññéçţ àţ ţĥé éñđ öƒ ţĥé ŕöŵ.
• Çöññéçţéđ, ƒöļļöŵéđ ƃý ŵĥàţ ţĥé àššîšţàñţ ĝéţš: ŕüļéš + çĥéçķ öñ éṽéŕý éđîţ ƒöŕ Çļàüđé Çöđé ŵîţĥ ţĥé ķàþî þļüĝîñ éñàƃļéđ, ŕüļéš öţĥéŕŵîšé.

Šĥöŵ ŵĥàţ îţ ŕéàđš, ƃéšîđé ţĥé ţîţļé, öþéñš ţĥé ŕüļéš ƒîļéš àñđ ţĥé ƃŕîéƒ ƒöŕ à ƒîļé, ŵĥîçĥ éṽéŕý àššîšţàñţ ŕéàđš àļîķé.

Šéššîöñš ļîšţš ŵĥàţ ŵàš ŕéçöŕđéđ îñ ţĥé þŕöĵéçţ, öñé ŕöŵ þéŕ šéššîöñ, ñéŵéšţ ƒîŕšţ: ţĥé àššîšţàñţ öŕ ţĥé þéŕšöñ ŵĥö ŵöŕķéđ, ŵĥéñ, àñđ ţĥé çöüñţš ţĥé šéššîöñ çàŕŕîéš, šüçĥ àš 2 suggestions · 1 correction. À đöţ ḿàŕķš à šéššîöñ ŵîţĥ à šüĝĝéšţîöñ šţîļļ ŵàîţîñĝ ƒöŕ ýöü. À šéššîöñ ţĥé çĥéçķ öñ éṽéŕý éđîţ ŕàñ îñ àļšö šĥöŵš ţĥé ƒîļéš îţ éđîţéđ, îţš çĥéçķš àñđ ŵĥàţ ţĥéý çàüĝĥţ, šüçĥ àš 3 files · 4 checks · 2 caught, öŕ 2 files · 3 checks · clean ŵĥéñ ñö çĥéçķ ƒàîļéđ.

Šţéþš

1. Öþéñ ţĥé þŕöĵéçţ. Çöññéçţîñĝ ŵŕîţéš ƒîļéš îñţö ţĥé þŕöĵéçţ, šö îţ ñééđš à çĥéçķöüţ öñ ţĥîš ḿàçĥîñé. À çöñţéẋţ-öñļý ţàƃ šàýš šö îñ þļàçé öƒ ţĥé ŕöŵš.
2. Çļîçķ Çöññéçţ öñ ţĥé ŕöŵ ƒöŕ ýöüŕ àššîšţàñţ. Ţĥé ŕöŵ ţüŕñš ţö Çöññéçţéđ àñđ ļîšţš ţĥé ƒîļéš îţ ŵŕöţé. Ĥöṽéŕ öṽéŕ Çöññéçţéđ ţö šéé ţĥé ƒîļéš ţĥàţ çàŕŕý ţĥé çöññéçţîöñ. Ƒöŕ Çļàüđé Đéšķţöþ, çöñƒîŕḿ ţĥé ƒîļé îţ ñàḿéš ƒîŕšţ.
3. Ţüŕñ öñ ţĥé çĥéçķ îñ Çļàüđé Çöđé. Ţĥé çĥéçķ ţĥàţ ŕüñš ŵĥéñ Çļàüđé Çöđé ƒîñîšĥéš çöḿéš ƒŕöḿ ţĥé ķàþî Çļàüđé Çöđé þļüĝîñ. Üñţîļ ţĥé þļüĝîñ îš éñàƃļéđ, ţĥé Çļàüđé Çöđé ŕöŵ ñàḿéš ţĥé ţŵö çöḿḿàñđš ţö ŕüñ îñšîđé Çļàüđé Çöđé: /plugin marketplace add neokapi/claude-plugins, ţĥéñ /plugin install kapi@neokapi-plugins.
4. Öþéñ ýöüŕ àššîšţàñţ îñ ţĥé þŕöĵéçţ ƒöļđéŕ. Çļàüđé Çöđé àšķš ýöü ţö àþþŕöṽé ţĥé þŕöĵéçţ'š ḾÇÞ šéŕṽéŕ ţĥé ƒîŕšţ ţîḿé. Ŕéṽîéŵ .mcp.json ƃéƒöŕé ýöü šàý ýéš, ţĥé ŵàý ýöü ŵöüļđ àñý ƒîļé à ŕéþöšîţöŕý šĥîþš. Çļàüđé Đéšķţöþ ŕéàđš îţš ƒîļé ŵĥéñ îţ šţàŕţš, šö ŕéšţàŕţ îţ.
5. Ŕéàđ à šéššîöñ. Ŵĥéñ ţĥé àššîšţàñţ ĥàš ŵöŕķéđ îñ ţĥé þŕöĵéçţ, îţš šéššîöñ àþþéàŕš üñđéŕ Šéššîöñš. Šéļéçţ îţ ţö öþéñ Šéššîöñš öñ îţ: éàçĥ éñţŕý îñ öŕđéŕ, ŵîţĥ Ķééþ àñđ Ñöţ à ŕüļé öñ à šüĝĝéšţîöñ šţîļļ ŵàîţîñĝ. Ŕéšéţ ţö ƃéƒöŕé ţĥîš šéššîöñ ĝöéš ƃàçķ ţö ĥöŵ ţĥé çöñţéẋţ šţööđ ƃéƒöŕé ţĥé šéššîöñ šţàŕţéđ.

Ŵĥàţ Çöññéçţ ŵŕîţéš

Çöññéçţ ŵŕîţéš ŵĥàţ kapi connect <assistant> ŵŕîţéš ƒöŕ ţĥàţ öñé àššîšţàñţ, àñđ ŕéþöŕţš éàçĥ ƒîļé àš çŕéàţéđ, üþđàţéđ öŕ ķéþţ. À šéçöñđ Çöññéçţ ķééþš éṽéŕý ƒîļé àš îţ îš.

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

Éṽéŕý àššîšţàñţ àļšö ŕéàđš ţĥé þŕöĵéçţ'š ŕüļéš ƒîļéš. Çöññéçţ ŵŕîţéš ţĥé þŕöĵéçţ'š ŕüļéš îñţö AGENTS.md àñđ CLAUDE.md, àţ ţĥé ŕööţ àñđ îñ éàçĥ ƒöļđéŕ ŵĥöšé ŕüļéš đéŕ, ŵĥéŕé àñ àššîšţàñţ ļöàđš ţĥéḿ àš îţ šţàŕţš. À ƒöļđéŕ öþéñéđ ŵîţĥöüţ à ŕéçîþé ĝéţš îţš kapi.yaml ƒîŕšţ, šîñçé ţĥé šéŕṽéŕ éñţŕý ñàḿéš îţ.

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

Çļàüđé Đéšķţöþ ŕéàđš öñé ƒîļé ƒöŕ éṽéŕý þŕöĵéçţ, öüţšîđé ţĥéḿ àļļ: ~/Library/Application Support/Claude/claude_desktop_config.json öñ ḿàçÖŠ àñđ %APPDATA%\Claude\claude_desktop_config.json öñ Ŵîñđöŵš. Ķàþî Đéšķţöþ ñàḿéš ţĥàţ ƒîļé àñđ àšķš ƃéƒöŕé îţ çĥàñĝéš îţ. Ţĥé éñţŕý ñàḿéš ţĥé kapi ƃîñàŕý ƃý îţš ƒüļļ þàţĥ, šîñçé àñ àþþ šţàŕţéđ ƒŕöḿ ţĥé Đöçķ öŕ ţĥé Šţàŕţ ḿéñü đöéš ñöţ ŕéàđ ýöüŕ šĥéļļ'š PATH.

Ŵĥàţ ţĥé àššîšţàñţ ţĥéñ đöéš

Ţĥé ķàþî šķîļļ àšķš àñ àššîšţàñţ ƒöŕ ƒöüŕ ĥàƃîţš:

1. Ƒöļļöŵ ţĥé ŕüļéš ƒîļéš. Îţ ŵŕîţéš ƃý ţĥé ŕüļéš îñ AGENTS.md àñđ CLAUDE.md ŵîţĥöüţ àšķîñĝ ƒîŕšţ, àñđ àšķš ķàþî öñļý àƃöüţ à ƒîļé ñö šéçţîöñ çöṽéŕš.
2. Ŕéçöŕđ ŵĥàţ ţĥé ƒîļéš đö éṽéŕý ţîḿé. À ñàḿé, à šþéļļîñĝ, à ŵöŕđ ţĥé ƒîļéš üšé ŵĥéŕé ŵŕîţéŕš öƒţéñ üšé àñöţĥéŕ: ŵĥàţ ţĥé ƒîļéš ķééþ ţö àñđ ţĥé ŕüļéš đö ñöţ ļîšţ ýéţ.
3. Ŕéçöŕđ ýöüŕ çöŕŕéçţîöñš. Ŵĥéñ ýöü çĥàñĝé à ŵöŕđîñĝ îñ îţš đŕàƒţ, îţ ŕéçöŕđš ţĥé çĥàñĝé àš à šüĝĝéšţîöñ.
4. Çĥéçķ ŵĥàţ îţ çĥàñĝéđ. Îţ ŕüñš kapi check öñ éàçĥ ƒîļé îţ çĥàñĝéđ àñđ ƒîẋéš ŵĥàţ ţĥé çĥéçķ ŕéþöŕţš. Ŵîţĥ ţĥé ķàþî þļüĝîñ, Çļàüđé Çöđé ŕüñš ţĥé þŕöĵéçţ'š çĥéçķ ŵĥéñ îţ ƒîñîšĥéš àñđ ķééþš ŵöŕķîñĝ ŵĥîļé à çĥéçķ ƒàîļš.

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

Ŵĥàţ ţĥé àššîšţàñţ ŕéçöŕđš àþþéàŕš îñ Ķàþî Đéšķţöþ ŵîţĥîñ à šéçöñđ öŕ ţŵö: üñđéŕ Ŵĥàţ'š ñéŵ öñ ţĥé ĥöḿé, öñ ţĥé þŕöĵéçţ'š Ḿàþ üñđéŕ Ŵĥàţ ýöüŕ ƒîļéš đö, îñ ţĥé þŕöĵéçţ'š Đéçîđé, àñđ àš à šéššîöñ öñ ţĥé Àššîšţàñţš þàĝé. À šüĝĝéšţîöñ àđṽîšéš àţ öñçé àñđ ƒàîļš ñö çĥéçķ. Îţ ƃéçöḿéš à ŕüļé ŵĥéñ ýöü ķééþ îţ. Ŕéṽîéŵ ŵĥàţ ýöüŕ àššîšţàñţ ñöţîçéđ ŵàļķš ţĥŕöüĝĥ đéçîđîñĝ.

Ţĥé šàḿé öñ ţĥé çöḿḿàñđ ļîñé

kapi connect ŵŕîţéš ţĥé šàḿé ƒîļéš ƒŕöḿ à ţéŕḿîñàļ:

kapi connect             # Claude Code, plus the assistants whose folders the project keeps
kapi connect cursor      # one assistant
kapi connect --dry-run   # what it would write, writing nothing

Šéé üšé ŵîţĥ Çļàüđé ƒöŕ éàçĥ ƒîļé àñđ ţĥé éđîţ àñđ Šţöþ ĥööķš, àñđ ŕüļéš ƒîļéš ƒöŕ àĝéñţš.

Ñéẋţ

• Ŕéṽîéŵ ŵĥàţ ýöüŕ àššîšţàñţ ñöţîçéđ: ţĥé ŕéṽîéŵ ļööþ, öñ ţĥé šàḿþļé.
• Üšé ŵîţĥ Çļàüđé: ŵöŕķîñĝ ŵîţĥ ķàþî ƒŕöḿ îñšîđé Çļàüđé.