v0.1.4

Full Changelog: v0.1.2...v0.1.4

v0.1.2

KAP v0.1.2

A patch release about setup: installing hooks once, and being able to tell whether recording works.

Added

• kap install puts the Claude Code hooks in ~/.claude/settings.json once per machine, so no
  project or worktree needs its own setup. Existing settings and other hooks are preserved, and
  kap uninstall removes only what KAP added.
• kap install --settings <path> writes the same hooks into any Claude-compatible settings file,
  so another CLI that fires the same events can be attached without KAP knowing its name.
• kap doctor answers "will this session be recorded?" — it checks that the hooks exist, that
  the binary they call still exists, that recording is not disabled, and whether the current
  directory is one where hooks record. It exits non-zero when recording would not happen.
• Turning recording off has three levels now: KAP_DISABLED=1 for one session, kap disable /
  kap enable for a repository, kap uninstall for the machine.
• kap status says whether the hooks are installed and whether recording is disabled here.

Changed

• A run no longer records which harness produced it. KAP talks to hooks, not to Claude Code, so any
  CLI emitting the same events is equally supported. Migration 0009 drops the column.

Fixed

• kap init outside a repository reported . instead of the resolved directory.
• Starting an attempt in a repository with no commits leaked git's ambiguous argument 'HEAD'; it
  now says that an initial commit is needed.

Install

cargo install kap-cli

Or take a binary from the assets below (macOS arm64 and x86_64, Linux x86_64), each with a
.sha256. Then kap install once.

v0.1.1

KAP v0.1.1

A patch release focused on reliability of the Claude Code path, plus the bugs reported after v0.1.0.

Reliability

• Hooks can no longer break an agent's turn. Malformed or empty input, a missing session id, or a
  locked database used to surface as a failed hook in Claude Code. Hooks now always exit 0 and write
  the failure to .kap/logs/hooks.log.
• A duplicated tool call is recorded once. Event ids derive from the tool call's id.
• Writers wait for the database instead of failing with "database is locked" (5s timeout).
• Output is bounded: 8 MiB per stream, 16 MiB per snapshotted file, with truncation marked.
• A malformed object address is an error, not a panic.

Fixed

• kap merge no longer fails because of untracked files unrelated to the attempt.
• kap attempt clean removes a merged branch along with its worktree, and keeps an unmerged one.
• kap status counts uncommitted and untracked files, and says that hooks record nothing in the main
  checkout.
• File evidence is stored relative to the worktree and deduplicated by content, so a hook and the
  stop snapshot no longer record the same edit twice.
• Three stray files from a test run were removed from the tree.

Added

• Claude Code subagent tool calls are attributed: the subagent's id and type are stored with the
  event. Schema migration 0008; existing stores migrate on open.

Install

macOS, Apple silicon:

curl -Ls https://github.com/Manifestro/kap/releases/download/v0.1.1/kap-aarch64-apple-darwin.tar.gz \
  | tar -xz -C ~/.local/bin

kap-x86_64-apple-darwin.tar.gz for Intel, kap-x86_64-unknown-linux-gnu.tar.gz for Linux. Each
archive has a .sha256. Or build with cargo install --git https://github.com/Manifestro/kap --locked.

v0.1.0

KAP v0.1.0 — pre-alpha

The first working version: record what an agent did, why it did it, and what backs the claim up.

What works

• Attempts — every attempt gets its own branch and git worktree, so agents do not collide.
• History — commands run through kap exec are recorded with their exit code and output, stored
  by BLAKE3 hash.
• Decisions — what was chosen, why, and what was rejected.
• Evidence — an artifact is hashed and stored and marked observed; a claim without one is kept
  as a claim and marked not observed.
• Claude Code adapter — hooks brief the agent at session start, record tool calls, and snapshot
  changed files on stop. KAP never wraps the agent or owns its loop.
• Snapshots — the whole worktree, tracked and untracked files included, without moving the
  branch; restoring opens a new attempt instead of overwriting one.
• Review-gated merge — a verdict is pinned to the commit it looked at, and the merge refuses
  without it.
• Sync — kap push / kap pull move history and objects through the git remote, one ref per
  machine.

Install

macOS, Apple silicon:

curl -Ls https://github.com/Manifestro/kap/releases/download/v0.1.0/kap-aarch64-apple-darwin.tar.gz \
  | tar -xz -C ~/.local/bin

macOS, Intel: kap-x86_64-apple-darwin.tar.gz. Linux x86_64: kap-x86_64-unknown-linux-gnu.tar.gz.
Each archive has a .sha256 next to it. Or build with
cargo install --git https://github.com/Manifestro/kap --locked.

Status

Pre-alpha: the CLI and the on-disk format will change before 1.0. Details in CHANGELOG.md.