OptimusPrime v1.0.0 — The session state protocol for AI coding

Claude is stateless. Your project isn't.

OptimusPrime is the first hook-level session state
protocol for AI coding. Runtime enforcement that fires
before execution. Cross-session memory that compounds
over time. Intelligence that gets smarter every session.

What's in v1.0.0

9 hooks — scope enforcement, loop detection,
dependency analysis, breaking change detection, output
compression, attempt logging, TODO accountability, done
checking, session snapshots

7 skills — scope contract extraction, decision
logging, confidence signaling, CLAUDE.md generation,
context restoration, cost awareness, production output
mode

Intelligence layer — contradiction detection across
decisions, topic clustering, predictive context injection
ranked by relevance not recency, cross-session learning
engine that adapts to your actual usage patterns

MCP server — 9 tools including reason_about(),
get_contradictions(), get_patterns() exposing full
project intelligence to any MCP-capable agent

CLI — op command with 9 command groups including
op intel ask, op intel patterns, op intel learned

Ecosystem Skills Hub — one-command install for
Superpowers, gstack, UI/UX Pro Max, caveman, ponytail.
Auto-updates. Contextual activation. Learns your
real activation thresholds from usage.

Benchmarks

Metric	Result
Output compression	63.9%
Scope guard latency	75ms (n=1000)
Loop detection	100% accuracy
Decision search	0.02ms avg
Session logger	0.12s
Input token reduction	40%+
Contradiction detection	163ms (n=50)
Context prediction	0.77ms avg
Learning cycle	1.8ms avg

Compression is non-destructive — code blocks untouched.

Install

git clone https://github.com/aarshsharma2803-stack/optimusprime
cd optimusprime
bash install.sh

Compatible agents

Claude Code · Antigravity · Cursor · Codex · Any MCP agent

What makes it different

Every other tool makes requests to Claude via CLAUDE.md.
Claude forgets them mid-session. OptimusPrime enforces
at the hook level — before execution, every time,
regardless of context window state.

And it gets smarter. Session 50 knows your patterns,
your preferred libraries, your failure history, your
real skill activation thresholds. Session 1 doesn't.

Built across 12 sessions. 123 decisions logged in
.optimusprime/decisions.md — ate our own cooking
through the entire build.

145 tests passing. MIT License.