The intelligence layer for AI software development
Agents are interchangeable. Context is the product.
HyperCode sits above coding agents — Claude Code, OpenCode, Codex, Gemini CLI, Aider, and local models — using PI Harness as the orchestration layer.
It is not another coding agent. It is the control plane that gives agents:
| Capability | Component |
|---|---|
| Persistent repo intelligence | HyperGraph |
| Minimal task context | HyperContext |
| Durable project knowledge | HyperMemory |
| Structured execution plans | HyperPlanner |
| Safer, scoped edits | ScopeGuard + DiffPilot |
| Focused test selection | HyperTest |
| Model routing | ModelRouter |
git clone https://github.com/desenyon/hypercode.git
cd hypercode
bash scripts/install.shOr globally:
npm install -g .This builds a self-contained ~1MB executable and links hypercode to your PATH.
cd your-project
hypercodeNo manual init. No manual index. HyperCode auto-initializes .hypercode/, indexes your repository, and opens a beautiful interactive TUI.
╭──────────────────────────────────────────────────────────────────────────╮
│ ██╗ ██╗██╗ ██╗██████╗ ███████╗██████╗ ██████╗ ██████╗ ██████╗ ███████╗
│ ... │
│ Intelligence layer for AI software development │
╰──────────────────────────────────────────────────────────────────────────╯
╭────────────────────────────────────────────────╮
│ Session │
│ ✓ Repository your-project │
│ ◈ HyperGraph 29 files · 168 symbols · 1 tests│
│ ⚡ Indexed just now │
╰────────────────────────────────────────────────╯
Quick commands
[ask] [plan] [graph]
[fix] [memory] [help]
hypercode › ask what is HyperGraph?
hypercode › plan add rate limiting
hypercode ask "where is authentication handled?"
hypercode plan "add codex adapter"
hypercode graph HyperGraphhyper is an alias for hypercode.
Developer Interface
│
▼
HyperCode CLI / TUI ◄── you are here
│
▼
Hyper Intelligence Layer
HyperGraph · HyperContext · HyperMemory · HyperPlanner
│
▼
PI Harness Orchestration
│
▼
Agent Adapters
│
▼
Claude Code · OpenCode · Codex · Gemini · Aider · Local
| Command | Description |
|---|---|
ask <question> |
Answer using repository intelligence |
plan <task> |
Create an execution plan |
graph [query] |
Explore the knowledge graph |
fix <issue> |
Plan and scope-check a bug fix |
memory list |
Show persistent project memory |
index |
Force rebuild HyperGraph |
status |
Show session status |
clear |
Clear screen |
help |
Show commands |
exit |
Quit |
Natural language works too: what is HyperGraph? · /plan add logging · prefix commands with /
HyperGraph — live structured repository representation
Tracks files, functions, classes, tests, docs, commits, and relationships (imports, calls, depends_on, tests, modified_by, and more).
Agents query HyperGraph before reading raw files.
HyperContext — smallest useful task context
Selects relevant symbols, files, tests, commits, architecture notes, and conventions per task.
HyperMemory — persistent project knowledge
type: architecture_decision
title: Use PI Harness for orchestration
status: accepted
reason: Agent coordination above individual coding agents.
impact:
- Agent adapters remain interchangeable
- HyperCode owns context and planningHyperPlanner — execution plans before any edits
Every plan includes affected files, steps, risk level, validation strategy, and rollback strategy.
ScopeGuard + DiffPilot + HyperTest — safety and validation
Scope enforcement, controlled diff previews, and focused test selection — not full-suite runs unless justified.
| Plugin | Purpose |
|---|---|
| Graphify Core | Knowledge graph extraction |
| Headroom Core | Context window optimization |
| Caveman Mode | Ultra-compressed agent output |
| ScopeGuard | Task drift prevention |
| DiffPilot | Controlled edit previews |
| TestSense | Intelligent test selection |
| SymbolLens | Symbol navigation |
| RepoMemory | Persistent knowledge |
| ModelRouter | Subtask model routing |
| CommandDock | TUI command palette |
| HyperDocs | Documentation sync |
| HyperObservability | Execution tracing |
npm install
npm run qa # typecheck + 24 tests + build
npm run hypercode # dev modesrc/
├── cli.ts Entry point
├── shell/repl.ts Interactive TUI
├── ui/ Theme, components, formatters
├── bootstrap.ts Auto-init + index
├── core/ HyperGraph, Context, Memory, Planner, ...
├── harness/ PI Harness integration
├── adapters/ Agent adapters
└── plugins/ Plugin registry
| Phase | Focus |
|---|---|
| MVP (now) | CLI, TUI, HyperGraph, ScopeGuard, DiffPilot, RepoMemory |
| V1 | CommandDock TUI, plugin marketplace, GitHub PR integration |
| Long term | Team memory, cross-repo intelligence, enterprise policy |
HyperCode makes every coding agent better without depending on any single one.
Models will change. Agents will change. HyperCode remains the system that understands the software.
MIT License · See AGENTS.md for agent operating instructions