kata 0.12.0

型 — the woodblock pattern. A multi-project template applier with AI-delegated merge for the files that resist mechanical sync.

Status: Phase 1 MVP shipped (local presets, overwrite mode, once / always timing). Not yet on crates.io. See ROADMAP.md for what's next (git-fetched templates, merge-section / merge-toml / merge-yaml / script modes, AI delegation, multi-PJ parallelism). Design notes in AGENTS.md.

Why

Maintaining N sibling Rust / Go / Bun projects means every boilerplate change to Makefile.toml / apm.yml / renri.toml / CI / AGENTS.md has to be copy-pasted across all of them. Existing tools (copier, cookiecutter, cruft) cover the mechanical case but nothing handles files that need judgement on update — like AGENTS.md, where each project has shared sections plus project-specific ones.

kata aims to:

• Layer templates — pj-base + pj-rust + pj-rust-cli compose, last layer wins. Avoid duplicating the common bits per language.
• Two-axis modes — how (overwrite / merge-section / merge-toml / merge-yaml / ai / script) and when (once / always / manual) are independent. how="ai", when="once" and how="script", when="always" both make sense.
• Delegate the un-mergeable — files marked how = "ai" get handed to your installed claude / gemini / codex CLI with the template diff and current contents. You see a diff and pick [a]ccept / [e]dit / [s]kip / [d]efer (chezmoi-style).
• Run in parallel — tokio fan-out across projects, with semaphores limiting AI concurrency so the agent CLI doesn't get fork-bombed.
• Truth lives with the project — each project's .kata/applied.toml records what was applied. The global registry is just paths.

Quick start

# Build from source (not on crates.io yet)
git clone https://github.com/yukimemi/kata
cd kata
cargo install --path .

# Apply a preset to a fresh project. Both local paths and git
# URLs work — kata clones the preset (and its referenced
# templates) into ~/.cache/kata/templates/ on first use.
mkdir my-rust-cli && cd my-rust-cli

# git URL form (clones pj-presets + every template it references):
kata init github.com/yukimemi/pj-presets:rust-cli --non-interactive

# or local path form (handy when iterating on a preset locally):
# kata init ~/src/github.com/yukimemi/pj-presets/rust-cli.toml

# Re-apply later when the templates evolve (idempotent; uses the
# cached clone — `kata update` to refresh)
kata apply --non-interactive

# Preview without writing
kata status

# Inspect what's tracked
kata list

The <source>:<preset-name> syntax is the same Terraform-module-style spec described in AGENTS.md: <source>[@<rev>][//<subdir>][:<preset-name>].

Global config

~/.config/kata/config.toml holds tool defaults under [defaults] (plus the [[project]] registry). Auto-update knobs:

[defaults]
auto_update = "install"      # off | notify | install
# update_check_interval = "24h"

Set KATA_NO_AUTOUPDATE=1 in the environment to disable the background check for a single invocation — it overrides auto_update to off regardless of config. (Non-empty and not 0 / false.)

Run kata self-update [--yes] [--check] to update on demand: --yes skips the confirmation prompt, --check reports availability without installing.

Companion repos

kata itself dogfoods these — the Makefile.toml / CI / etc. in this repo are managed by kata apply from pj-presets:rust-cli.

License

MIT.