Skip to main content
~/projects/orbit — claude --plugin orbit
Orbit · v0.2.1 · MIT · Claude Code Plugin

Find drift between what you asked
and what actually shipped.

Orbit mines the Claude Code session transcripts already on your disk under ~/.claude/projects/ and compares user intent against plan items, assistant claims, tool evidence, and current codebase state. Outputs a static dashboard, evidence JSON, gap-analysis markdown, and a durable intent ledger — no Docker, no Python package install, no re-capture.

4
Skills
8
Commands
2
Hooks
12
Evidence Ranks
0
Fakes Shipped

Plans are evidence. Claims are claims.

Orbit treats plans as evidence, not historical truth; assistant claims as claims, not proof; and codebase validation as required before completion is trusted. The 12-rank evidence ladder is honored across every analyzer.

01
Mine what already exists
Claude Code already stores sessions locally under ~/.claude/projects/. Orbit reads them in JSONL time order, normalizes events through a fixed key allowlist, and never duplicates capture or requires Docker.
02
12-rank evidence ladder
Later instruction beats earlier plan. Tool-result beats assistant claim. Codebase truth beats inferred narrative. Every analyzer respects the same 12-level evidence ranking — no silent downgrade to PASS.
03
Refusal when proof is missing
Plan omission is not proof never-requested. Missing evidence is uncertainty, not absence. Gap analyzer flags drift without manufacturing claims; orange/red status accents stay confined to the in-page surfaces that own them.

Install. Audit. Read the dashboard.

Orbit ships as a Claude Code plugin. Add the marketplace, install the plugin, then run /orbit:audit-gaps on any project. Two examples below — one default 3-day audit, one cross-project window.

bashexample 1 · install & default 3-day audit
# 1. Add the marketplace and install the plugin.
$ claude plugin marketplace add krzemienski/orbit
$ claude plugin install orbit@orbit

# 2. Run the default 3-day audit on the current project.
$ /orbit:audit-gaps
# Phase 1 — scope detector ........... .claude/audits/latest/scope.json
# Phase 2 — plan extractor ........... 7 plan items found in plans/
# Phase 3 — JSONL session reader ..... 142 events normalized
# Phase 4 — intent / claim / tool .... 18 intents · 24 claims · 51 tool pairs
# Phase 5 — gap analyzer ............. 3 unverified claims · 1 plan-not-shipped
# Phase 6 — dashboard render ......... .claude/audits/latest/dashboard.html
→ outputs at .claude/audits/latest/{dashboard.html, evidence.json, gap-analysis.md}
bashexample 2 · cross-project drift over 30 days
# Pin two project families and a 30-day window. Repeatable --project-filter
# scopes the mine; --all-projects switches to global.
$ /orbit:review-window --project-filter orbit --project-filter blog-series --days 30
# Mining ~/.claude/projects/-Users-nick-Desktop-orbit/*.jsonl + blog-series
# 412 events · 67 intents · 89 claims · 174 tool pairs
→ cross-project gap report at .claude/audits/cycle-260508/dashboard.html

# Append today's intents to the durable ledger.
$ /orbit:rebuild-ledger
→ wrote intent-ledger.jsonl + intent-ledger.md

Intent → evidence → gap. One flow.

Every /orbit:audit-gaps run flows through the same scope-detect → mine → normalize → analyze → validate → render pipeline. Each stage drops evidence into .claude/audits/<run>/; the gap analyzer never silently downgrades missing evidence to PASS.

Six phases. One twelve-rank ladder.

Each phase has a single responsibility and a single output artifact. Internally, each comparison respects the 12-level evidence ranking — later instruction beats earlier plan, tool-result beats claim, codebase truth beats inference.

PH 01
Intent
User asks → command/skill → scope
PH 02
Plan
Extract plan items from .md files
PH 03
Claim
Mine assistant claims from JSONL
PH 04
Tool
Pair tool-use + tool-result evidence
PH 05
Codebase
Validate against current repo truth
PH 06
Gap
Render dashboard.html + reports

What ships in v0.2.1.

Counts grounded in the on-disk plugin tree at github.com/krzemienski/orbit @ 5ff9919d. Each row enumerates the actual files — no estimates, no rounding.

Category
Members
Count
Skills
gap-analysis · instruction-ledger · plan-execution-audit · validation-pairing
4
Commands
audit-gaps · mine-intent · validate-claims · compare-plan · render-dashboard · review-window · review-last-3-days · rebuild-ledger
8
Hooks
UserPromptSubmit (hook_instruction_detector.py) · UserPromptExpansion (hook_prompt_context.py)
2
Evidence Ranks
later-instruction · correction · session-evidence · tool-use · tool-result · codebase · validation · earlier-instruction · plan · claim · inference · metadata
12
Engine
scripts/orbit_audit.py — single Python module, no package install, no Docker
1

One marketplace. One plugin.

Orbit installs as a Claude Code plugin. The plugin ships 4 skills, 8 commands, 2 hooks, and the scripts/orbit_audit.py engine. No package install, no Docker, no SaaS — outputs land in .claude/audits/.

bashinstall orbit into Claude Code
# Add marketplace + install plugin.
$ claude plugin marketplace add krzemienski/orbit
$ claude plugin install orbit@orbit

# Run the default 3-day audit on the current project.
$ /orbit:audit-gaps

# Open the dashboard.
$ open .claude/audits/latest/dashboard.html

# Cross-project review window.
$ /orbit:review-window --all-projects --days 7

# Append today's intents to the durable ledger.
$ /orbit:rebuild-ledger

Read the source. Then audit.

Orbit has no SaaS, no telemetry, no closed source. Every skill, command, hook, and rule lives in the public repository. Below: the eight pages most worth your time on day one.

Plans are evidence, not history. Assistant claims are claims, not proof. Codebase validation is required before completion is trusted.

v0.2.1 — time windows + cross-project mining.

Orbit shipped v0.2.1 on 2026-05-08 with cross-project mining flags, durable intent ledger, and a hand-written static dashboard. Roadmap items below v0.3 are being shaped by real audit runs against the very repo you are reading.

v0.2.1
May 2026
Time windows + cross-project mining. --days, --since, --from/--to, repeatable --project-filter, and --all-projects. Durable intent ledger and hand-written dashboard ship with this cut.