Callimachus v0.12.1

Patch Changes

• 7473a84: A Cursor plugin (plugins/cursor, listed by .cursor-plugin/marketplace.json at the repo root so Cursor's marketplace import and cursor.directory find it): the recall skill, the MCP server (npx -y callimachus-mcp, pinned to the release) and sessionStart / sessionEnd hooks that run cal hook --for cursor and cal session-end --for cursor through ~/.local/bin/cal, staying silent when cal is missing or too old for Cursor's protocol. With both the plugin and the app's own Cursor hooks (Settings > Agents), cal hook --for cursor now injects the memory once per conversation: the first hook claims it with a marker file under ~/.callimachus/recall, which cal session-end --for cursor removes and a week-old one is pruned.

• a97e1b5: The Claude Code plugin's hooks are now short shell scripts inside the plugin (scripts/hook.sh, index.sh, snapshot-hook.sh, session-end.sh) instead of inline commands. Anthropic's plugin directory allows no variable other than the plugin root in a hook command, and the scripts are easier to read. What they run is unchanged: the cal CLI at ~/.local/bin/cal, quietly skipped when it is not installed.

• 60bef36: The Claude Code plugin now ships the MCP launcher inside the plugin (mcp/, a copy of the callimachus-mcp npm package) and runs it with node instead of npx. It downloads the same release binary and checks it against the release's SHA256SUMS before running it, with no npm registry lookup at session start. The plugin also gains a listing icon.

• 42aec5a: The first five minutes: a report that shows what your agents have done, provenance you can see while coding, and memory for Copilot and Cursor.

  • "Your agents, so far". One screen over the whole index: sessions per agent and estimated hours, spend by agent and model (all time and the last 30 days) with the priciest commits, the most frequent recurring errors and their fixes, tasks asked again on another day, project memory, the files agents changed most, and the value ledger. Open it from a card on Today after the first index, or from Stats; copy it as markdown or save a 1200 x 630 PNG card to Downloads. The setup checklist gains a "See your report" step. cal report [--since DAYS] [--markdown] [--json] prints the same report, with a versioned schema at callimachus.app/schemas/cal/report.v1.json.
  • Provenance in the editor, and Agent Trace both ways. The VS Code / Cursor extension marks the lines a past AI session wrote in the gutter and explains them on hover (the session, its agent and date, up to three of its decisions or gotchas, with Open session and Why this line), from one background cal why per file version; turn it off with callimachus.whyGutter and callimachus.whyHover. With --json-version 1, cal why now returns each commit's line ranges and its Agent Trace attributions (plain --json is unchanged); it can also blame an unsaved buffer (--stdin) and takes -n. Trace logs are read and written without following symlinks, and exported records name no path on your machine. When a repository carries Agent Trace records (agent-trace.dev) in .agent-trace/, cal why and the threads_for_file MCP tool show the agent, model and conversation another tool recorded for a line, even one Callimachus has no transcript of; cal trace export writes records for the commits your sessions produced (--dry-run, --since, -o), with a versioned schema at callimachus.app/schemas/cal/trace.v1.json.
  • Memory for GitHub Copilot and Cursor. Settings > Agents adds cal hook --for copilot to ~/.copilot/hooks/callimachus.json (Copilot CLI and VS Code's Copilot sessions) and cal hook --for cursor to ~/.cursor/hooks.json (onboarding offers Cursor's too), so both get the repo's memory when a session starts, like Codex and Gemini CLI, with SessionEnd hooks that queue the ended session for auto-distill (Copilot CLI sessions; VS Code Copilot sessions are not indexed from Copilot's session store yet). The first Cursor chat after a restart, or a first prompt sent right away, can miss the memory, since Cursor does not wait for the hook. Cursor also runs the Claude Code hooks it imports; those now stay quiet for a Cursor chat, so the memory arrives once. The privacy policy and SECURITY.md name the new hook connections.

---

Install: macOS .dmg (Apple Silicon), Windows .msi or -setup.exe, Linux .AppImage, .deb or .rpm (glibc 2.38+). Installed apps update themselves. The standalone cal-<target> and callimachus-mcp-<target> binaries are for CLI/MCP-only use; their SHA-256 sums are in SHA256SUMS.