Claude Code Op

Maximum token efficiency for Claude Code — one install, every project.

Developed by Ordis AI

---

What it does

Claude Code Op wires together 5 tools that each attack token waste from a different angle. The result is a Claude Code environment that reads faster, writes less, remembers more, and costs a fraction of vanilla Claude Code.

[CAVEMAN:ULTRA] [CTX:ON] [CRG:ON] [SYM:ON] [MEM:your-project]
Sonnet 4.6 | ████░░░░ 42% | 5h:23% | 7d:11% | $0.018

Two-line statusline. Every tool visible. Every project scoped automatically.

---

The stack

Tool	What it does	Token impact
Caveman	Compresses Claude's output to terse prose	65–75% output tokens saved
lean-ctx	Replaces file reads with cached compressed versions	Up to 99% per file read
code-review-graph	Builds a knowledge graph of your codebase, only sends relevant files	8.2× average reduction
SymDex	Pre-indexed symbol/function lookup instead of full-file reads	97% per symbol lookup
claude-mem	Persists session observations across restarts, no re-explaining	Cross-session context

Combined: 80–99% fewer tokens depending on workload. See BENEFITS.md for real benchmark data.

---

Install

One command (recommended)

npx claude-code-op

That's it. On first run it:

1. Installs Claude Code (via curl -fsSL https://claude.ai/install.sh | bash) if not present
2. Installs uv, Bun, lean-ctx, code-review-graph, symdex, Caveman, claude-mem
3. Wires hooks, MCP servers, and the 2-line statusline into ~/.claude/
4. Shows the animated gigchad Claude banner and launches Claude Code

On every subsequent run, npx claude-code-op just shows the banner and opens Claude Code. Pass --reinstall to re-run the full setup. The package auto-detects newer versions and updates itself silently.

First-time login: Claude Code handles auth itself. When you run claude for the first time after install, a browser window opens for OAuth. Requires a Claude Pro / Max / Team / Enterprise account.

Flags

Flag	Effect
(none)	Fresh install on first run, launcher on repeat runs
--reinstall	Force re-run the full install even if already set up
Any other args	Passed through to claude (e.g. npx claude-code-op -c)

Alternative (clone + bash)

git clone https://github.com/ordisaidev/claude-code-op
cd claude-code-op
chmod +x install.sh
./install.sh

Requirements

• macOS or Linux (Windows: run irm https://claude.ai/install.ps1 | iex first)
• Node.js 18+
• curl

Everything else — Claude Code, uv, Bun, Rust/cargo, all tools — is installed automatically.

Claude Code

Claude Code is Anthropic's official CLI. Source: github.com/anthropics/claude-code

---

How scoping works

Everything is global by default, project-local by data.

The MCP servers run globally (registered in ~/.claude.json). On every session start, a hook detects the current working directory and:

• Builds .code-review-graph/ in that project (first visit only, background)
• Builds .symdex/ in that project (first visit only, background)
• Points claude-mem to .claude-mem/ in that project

You get fresh, isolated intelligence for every codebase — no cross-project contamination. Subfolders inherit the parent project's indexes.

~/projects/
  my-app/
    .code-review-graph/   ← graph scoped to my-app
    .symdex/              ← symbols scoped to my-app
    .claude-mem/          ← memory scoped to my-app
  other-project/
    .code-review-graph/   ← completely separate
    .symdex/
    .claude-mem/

---

Statusline

The statusline updates live after every Claude response.

Line 1 — tool badges:

Badge	Color	Meaning
[CAVEMAN:ULTRA]	Orange	Caveman speech level
[CTX:ON/OFF]	Green/Grey	lean-ctx file compression
[CRG:ON/OFF]	Blue	code-review-graph active
[SYM:ON/OFF]	Purple	SymDex symbol index active
[MEM:foldername]	Pink	claude-mem active, showing current project

Line 2 — session stats:

Field	Description
Sonnet 4.6	Current model
████░░░░ 42%	Context window usage (green → yellow → red)
5h:23%	5-hour rate limit usage (Pro/Max only)
7d:11%	7-day rate limit usage (Pro/Max only)
$0.018	Session cost (only shown when > $0)

---

Toggle commands

Say these to Claude mid-session:

What to say	Effect
caveman ultra / caveman lite / stop caveman	Change speech compression level
ctx off / ctx on	Disable/enable lean-ctx file reads
use normal file read	Disable lean-ctx (alias)
crg off / crg on	Disable/enable code-review-graph
graph off / disable graph	Disable code-review-graph (alias)
sym off / sym on	Disable/enable SymDex
mem off / mem on	Pause/resume claude-mem

All flags reset to ON on every new session.

---

Hook architecture

SessionStart
  ├── caveman-activate.js       → loads caveman ultra rules
  ├── lean-ctx-session-init.js  → resets CTX flag to "on"
  ├── project-init.js           → bg-builds CRG + SYM indexes for cwd
  ├── smart-install.js          → checks claude-mem deps (bun, chroma)
  ├── worker-service start      → starts claude-mem worker on :37777
  └── worker-service context    → injects past session memory

UserPromptSubmit (every prompt, fast <5s total)
  ├── caveman-mode-tracker.js   → detects /caveman mode switches
  ├── lean-ctx-toggle.js        → detects "ctx off/on"
  ├── graph-toggle.js           → detects "crg/sym off/on"
  └── mem-toggle.js             → detects "mem off/on"

PostToolUse (after Edit/Write/Bash)
  ├── crg-update.sh             → updates knowledge graph (background)
  └── worker-service observation → saves tool use to memory (background)

PreToolUse
  ├── lean-ctx hook rewrite     → rewrites bash commands through lean-ctx
  └── lean-ctx hook redirect    → redirects file reads through ctx_read

Stop / SessionEnd
  └── worker-service summarize  → saves session summary to memory

---

MCP servers

Registered globally in ~/.claude.json:

Server	Tools	Purpose
lean-ctx	34 tools (ctx_read, ctx_shell, ctx_search, …)	Compressed file reads and shell output
code-review-graph	22 tools	Codebase knowledge graph, blast-radius analysis
symdex	20 tools	Symbol search, call graphs, route lookup
claude-mem	4 tools (search, timeline, get_observations, …)	Persistent memory search

---

File layout

claude-code-op/
├── install.sh                  # One-command installer
├── uninstall.sh                # Clean removal
├── BENEFITS.md                 # Real benchmark data from each tool
├── hooks/
│   ├── combined-statusline.js  # Two-line live statusline
│   ├── project-init.js         # Background CRG + SYM init per project
│   ├── lean-ctx-session-init.js
│   ├── lean-ctx-toggle.js
│   ├── graph-toggle.js
│   ├── mem-toggle.js
│   └── crg-update.sh
├── config/
│   ├── CLAUDE.md               # Global rules (lean-ctx + long-running processes)
│   └── caveman-config.json     # Caveman ultra default
└── scripts/
    ├── merge-settings.js       # Safe-merge hooks into ~/.claude/settings.json
    └── merge-mcp.js            # Safe-merge MCP servers into ~/.claude.json

---

Uninstall

./uninstall.sh

Removes hooks and flags. Tool binaries stay. To remove tools individually:

lean-ctx uninstall
uv tool uninstall code-review-graph
uv tool uninstall symdex
claude plugin uninstall caveman@caveman

---

License

MIT — Developed by Ordis AI