clanker

Launch AI harnesses with runtime-configured context, domains, models, and prompts

Getting started

Toolchain, task execution, and hook tools are managed by mise. The Rust toolchain is declared in mise.toml; rustup is an implementation detail and rust-toolchain.toml is intentionally absent. With direnv installed, entering the directory prepares the environment. Otherwise:

mise trust --quiet
mise install
mise run sync

Tasks

mise run check  # check-only hooks, as CI runs them
mise run lint   # manual autofix hooks
mise run test   # test suite
mise run ci     # full CI gate

The generated Rust gate includes formatting, TOML formatting, shell linting, spelling, clippy, nextest, docs, unused-dependency detection, advisory audit, license/source policy, packaging, and at least 95% line coverage. The coverage floor is 95% rather than the generated 100% because the binary entry in src/main.rs (process::exit on a failed process environment, and the real hostname -s failure arms), the execute_plan process replacement that never returns on success, a few structurally-unreachable command and slicing guards, and filesystem I/O error-map closures that require OS-specific or permission errors cannot be exercised by a genuine, network-free, in-process test. The plan building, drift, prompt, config, context, and session logic is otherwise covered by inline unit tests, and every offline command is driven through the binary, keeping actual coverage near 95.7%. See REPO_INVARIANTS.md RS-007.