Skip to content

v0.1.0 — Claude Code

Choose a tag to compare

@IngTian IngTian released this 03 Jul 14:37

First tagged release of claude-witness — a Claude Code plugin that keeps a person-centric archive of how you think, work, and grow across sessions. This is a stable, end-to-end-verified cut of the Claude Code integration.

What's in this release

  • Capture (L0) — every turn recorded verbatim from stable Claude Code hook fields (UserPromptSubmit.prompt, Stop.last_assistant_message); no fragile transcript parsing. Append-only, never LLM-touched.
  • Distillation (L1/L2/L4) — a detached worker mines per-session observations, a periodic reviewer synthesizes them into bi-temporal facets, and profiles are regenerated on top. Runs on your existing Claude Code auth via claude -p.
  • Local & self-contained — one pure-Go static binary (CGO_ENABLED=0), local multilingual (EN + ZH) embeddings via GoMLX. No Python, no external services, no vector DB, no cloud key.
  • MCP server — agents read the profile on demand via get_profile / get_facets / search_observations / record_observation / delete_observation.
  • Lenses — pluggable observation dimensions; ships with a default lens and a lens-authoring guide.
  • Commandswitness <doctor | profile | lens | cleanup | install | uninstall>.

Verified

gofmt, go vet, go test ./..., and make build-all (darwin/linux × amd64/arm64) all green at this commit.

Install

./install.sh        # builds, fetches the embedding model (~448MB, once), wires hooks + MCP

Or download a prebuilt binary below and run witness install. The embedding model is fetched separately on first run (not bundled in the binary).

Scope note

This release is the Claude Code integration. OpenCode support is in progress on a separate branch and is not part of v0.1.0.

Assets

Prebuilt binaries for darwin/linux × amd64/arm64, plus SHA256SUMS.txt. Verify with shasum -a 256 -c SHA256SUMS.txt.