Skip to main content

kapi voice pointer

kapi pointer

Write a short, marker-delimited section into the project's assistant file telling an assistant that the project's voice is held by kapi and that 'kapi voice guide' retrieves it. The section names the voice and nothing else; the guide itself stays one command away, so the pointer never goes stale.

An existing CLAUDE.md or AGENTS.md at the project root takes the section (CLAUDE.md when both exist); with neither, CLAUDE.md is created. A section that lands in AGENTS.md reaches an assistant limited to CLAUDE.md through an import line there: @AGENTS.md. Running again replaces the section in place and leaves the rest of the file untouched. When the project binds no voice, a section written earlier is removed and nothing else is written.

'kapi init' writes the same section when the project it scaffolds binds a voice; run this after binding one to an existing project, or after renaming the profile.

Commandvoice pointer
Try it

Runs in your browser against a small sample file. Edit the command before running, or press Run to execute it as shown.

kapi voice pointer
Flags
FlagTypeDefaultDescription
--colorstringautocolorize output: auto, always, never
--jqstringfilter JSON output through a jq expression (implies --json)
--jsonboolfalseOutput in JSON format
--output-formatstringOutput format: text (alias: table), json, yaml
--project, -pstringpath to a kapi.yaml project recipe or its directory (auto-discovered from cwd if omitted)
--textboolfalseOutput in text format (default)

← Back to the Command Reference