Skip to main content

Find drift between what you asked, what you planned, what was claimed, and what shipped.

A Claude Code plugin for finding drift between what you asked, what was planned, what was claimed, and what actually shipped — sourced from the session transcripts already on your disk.

Orbit is a Claude Code plugin that mines existing local session transcripts under ~/.claude/projects/ — current project, filtered project sets, or all projects — and compares user intent against plan evidence, assistant claims, tool evidence, and current codebase truth.

Inventory: 4 skills, 8 slash commands, 2 hooks, 1 Python audit engine. Outputs a static dashboard, evidence JSON, gap-analysis markdown, intent-timeline mermaid, and an append-only intent ledger — all under .claude/audits/.

Iron rule: plans are evidence, not historical truth. Assistant claims are claims, not proof. Codebase validation is required before completion is trusted.

Mines what already exists

Claude Code already stores sessions locally under ~/.claude/projects/. Orbit reads them in order, never duplicates capture, and never requires Docker or a Python package install.

12-level evidence ranking

Later user instruction > correction > direct session evidence > tool-use > tool-result > codebase state > validation > earlier instruction > written plan > assistant claim > inference > metadata. Honored across every analyzer.

Cross-project review windows

--days N | --since YYYY-MM-DD | --from/--to. Repeatable --project-filter and --all-projects flags surface drift across project families, not just within one repo.

Refusal when proof is missing

Plan omission is not proof never-requested. Missing evidence is marked uncertainty, not absence — gap analyzer never silently downgrades to PASS.

# install via Claude Code marketplace
claude plugin marketplace add krzemienski/orbit
claude plugin install orbit@orbit

# 3-day default audit on the current project
/orbit:audit-gaps
# or explicit window
/orbit:review-window --days 7

# Cross-project drift across two project families
/orbit:review-window --project-filter orbit --project-filter blog-series --days 30

# Append today's intents to the durable ledger
/orbit:rebuild-ledger
  1. 01claude plugin marketplace add krzemienski/orbit
  2. 02claude plugin install orbit@orbit
  3. 03Run /orbit:audit-gaps to execute the default 3-day audit on the current project
  4. 04Inspect outputs at .claude/audits/latest/dashboard.html, gap-analysis.md, evidence.json
  5. 05Run /orbit:rebuild-ledger to append today's user instructions to the durable intent ledger
Local session mining (~/.claude/projects/)
No re-capture, no Docker
12-level evidence ranking
Honored across analyzers
Cross-project review windows
--all-projects + --project-filter
Time windows
--days / --since / --from-to
Static dashboard + mermaid diagrams
.claude/audits/latest/
Durable intent ledger
intent-ledger.{jsonl,md}
UserPromptSubmit + UserPromptExpansion hooks
Live ledger candidate capture
Documentation
Read the Orbit docs
orbit.withagents.dev