kapi init

$ kapi init

Create a new kapi project with a kapi.yaml recipe and an adjacent .kapi/ state directory.

By default kapi init scaffolds a content project that keeps your source in voice: a voice profile, the project terms store, and a check flow, with no target languages. Pass --target-locale (or --framework) to make it a translation project instead.

The project name defaults to the current directory's basename and the source locale to en. Override with --name, --source-locale, --target-locale (repeatable).

Every project kapi scaffolds is given a stable id under 'id:' in the recipe. It survives a rename, a move and a clone, and everything kapi records about the project is keyed on it. A recipe written before this and carrying no id keeps working, identified by its name; --mint-id writes one into it, leaving the rest of the file exactly as it is.

--preset <name> (alias: --framework) pre-fills the content mapping for a known stack's i18n catalogs: react-i18next, react-intl, nextjs, vue-i18n, flutter, angular, and scaffolds the translation project. List every preset (framework scaffolds plus per-format parsing presets) with --list-presets.

When the project binds a voice profile, kapi init also writes a short section into the project's assistant file, so an assistant working in the tree knows the voice is held by kapi and retrieves it with 'kapi voice guide' before writing. An existing CLAUDE.md or AGENTS.md at the root takes the section (CLAUDE.md when both exist); with neither, kapi init creates CLAUDE.md. Re-running replaces the section in place and leaves the rest of the file alone. --no-pointer skips it; 'kapi voice pointer' writes it later.

Commandinit

Groupwork

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 init

Flags

Flag	Type	Default	Description
--dir	string		Directory to scaffold in (default: current directory)
--framework	string		Pre-fill content mapping for a known stack (see 'kapi init --list-presets'); scaffolds a translation project
--list-presets	bool	false	List available presets (framework scaffolds and per-format parsing presets) and exit
--mint-id	bool	false	Write a stable project id into a recipe that has none, and print the id
--name	string		Project name (default: directory basename)
--no-pointer	bool	false	Do not write the voice pointer into CLAUDE.md or AGENTS.md
--preset	string		Scaffold from a named framework preset (see 'kapi init --list-presets'); alias of --framework
--source-locale	string	en	Source locale (BCP-47)
--target-locale	stringSlice		Target locale (repeatable)

← Back to the Command Reference