Package Exports
- dino-spec
Readme
dino-spec
Automatic context engineering for Claude Code
__
(_ \
.-^^^ /
/ /
<__|-|__|dino-spec brings structured, context-aware development to Claude Code. It automatically maintains session state, provides 33 MCP tools, and enables intelligent context retrieval with real-time statusline display.
Features
- MCP Integration - 33 tools + 19 resources auto-configured during init
- Session State - Automatic tracking of focus, test/build/lint status, blockers
- Persistent Memory - Decisions, patterns, learnings survive across sessions
- Interactive Memory Browser - TUI for browsing memories with vim-style navigation (v9.0.0)
- Real-Time HUD - Statusline integration showing budget, phase, tests, focus, git status (v9.1.0)
- Session Handoff - Context continuity system for seamless session transitions (v9.1.0)
- Workflow Skills - Phases from discovery to completion (
/dino.*) - Task Delegation - Specialized agents with context handoffs
- Recursive Agents - Self-spawning agents with complexity-based depth control (v8.0.0)
- Recursive Retrieval - RLM-style query decomposition with quality feedback
- Dynamic Partitioning - Intelligent codebase segmentation (directory, feature, dependency, time)
- Context REPL - Declarative DSL for model-driven exploration
- Context Engineering - Research-backed token optimization (v9.6.0, v9.7.0)
- Tool result summarization (~50-70% better retention)
- Positional context optimization (~15-25% recall improvement)
- Just-in-time context loading (~60-80% initial context reduction)
- Entropy-guided budgeting (~20-30% token reduction)
- Virtual memory management (~40-50% memory overhead reduction)
- Multi-agent context isolation (~70-80% token reduction for parallel agents)
- Semantic memory validation (~20-30% better relevance)
- Reference docs and skills (
/research,/context-optimize)
Installation
npm install -g dino-specQuick Start
cd your-project
dino init # Analyze codebase, install hooks, configure MCP
# MCP server is auto-configured for Claude Code
# Use /mcp in Claude Code to verifyCLI Commands
| Command | Description |
|---|---|
dino init |
Initialize project (hooks + MCP) |
dino init --minimal |
Minimal CLAUDE.md with MCP resources |
dino init --bootstrap |
Include project analysis summary |
dino status |
Show session state and health |
dino refresh |
Re-analyze codebase |
dino update |
Update managed files |
dino update --scope mcp |
Fix MCP configuration |
dino memory list |
Show persistent memories |
dino memory search <query> |
Search memories |
dino memory browse |
Interactive memory browser TUI (v9.0.0) |
dino retrieve <query> |
Hybrid file retrieval |
dino hud install |
Install statusline integration (v9.1.0) |
dino hud preview |
Preview HUD output (v9.1.0) |
dino handoff create |
Save session context for continuity (v9.1.0) |
dino handoff load |
Load handoff context (v9.1.0) |
dino mcp serve |
Start MCP server (auto-managed) |
Workflow Skills
Use in Claude Code with /dino.<phase>:
| Phase | Skill | Purpose |
|---|---|---|
| Discover | /dino.discover |
Capture requirements |
| Scout | /dino.scout |
Research codebase |
| Sniff | /dino.sniff |
Clarify ambiguities |
| Nest | /dino.nest |
Plan implementation |
| Hatch | /dino.hatch |
Break into tasks |
| Hunt | /dino.hunt |
Execute implementation |
| Aging | /dino.aging |
Verify with tests |
| Fossil | /dino.fossil |
Archive and commit |
Utilities: /dino.status, /dino.focus, /dino.next, /dino.handoff (v9.1.0), /dino.release (v9.4.0)
Context Engineering: /research (v9.7.0), /context-optimize (v9.7.0)
MCP Resources
Access via @dino:// in Claude Code:
| Resource | Description |
|---|---|
@dino://session |
Focus, blockers, test status |
@dino://structure |
Project architecture |
@dino://patterns |
Coding conventions |
@dino://commands |
Build/test/lint commands |
@dino://tasks |
Task registry and progress |
@dino://handoff |
Agent handoff context |
@dino://memories/summary |
All memories overview |
@dino://retrieval/ranked |
Session-relevant files |
MCP Tools
Key tools available via Claude Code:
| Tool | Purpose |
|---|---|
dino_status |
Get session state |
dino_focus_set |
Set focus area |
dino_memory_recall |
Semantic memory search |
dino_context_repl |
Declarative context queries |
dino_recursive_query |
RLM-style retrieval |
dino_partition |
Intelligent codebase partitioning |
dino_agent_analyze |
Analyze task complexity for spawn decisions |
dino_agent_spawn_decision |
Get recursive agent spawn recommendation |
dino_agent_tree |
Display agent execution tree |
dino_task_create |
Create task in registry |
dino_plan_create |
Create implementation plan |
dino_graph_query |
Query knowledge graph entities |
dino_graph_relations |
Find entity relationships |
dino_graph_architecture |
Architectural analysis (cycles, dependencies) |
dino_retrieve |
Hybrid code retrieval (keyword + semantic + graph) |
dino_retrieve_similar |
Find similar files |
dino_embed_search |
Semantic code search with embeddings |
dino_embed_stats |
Vector store statistics |
dino_chunk_file |
AST-based semantic chunking |
dino_chunk_analyze |
Chunking analysis |
Specialized Agents
| Agent | Role | Purpose |
|---|---|---|
@dino-analyst |
Explorer | Read-only codebase research |
@dino-architect |
Planner | Design and planning |
@dino-implementer |
Implementer | Full implementation |
@dino-tester |
Tester | Test writing/execution |
@dino-reviewer |
Reviewer | Code review and QA |
Memory System
Persistent memories in .dino/memories/:
| Type | Half-Life | Purpose |
|---|---|---|
| Decisions | 30 days | Architectural choices |
| Patterns | 14 days | Coding preferences |
| Learnings | 7 days | Session discoveries |
dino memory list # View all memories
dino memory search "auth" # Search memories
dino memory decay # Clean stale memoriesProject Structure
your-project/
├── CLAUDE.md # Project context
├── .claude/
│ ├── skills/dino/ # Workflow skills
│ ├── rules/dino/ # Workflow rules
│ └── agents/ # Specialized agents
└── .dino/
├── session.md # Session state
├── structure.json # Codebase analysis
├── tasks/ # Task registry
├── checkpoints/ # Agent checkpoints
└── memories/ # Persistent memoryRequirements
- Node.js >= 20.0.0
- Claude Code CLI
Troubleshooting
MCP not showing in /mcp
# Windows
claude mcp add-json --scope user dino '{"command":"cmd","args":["/c","npx","dino-spec","mcp","serve"]}'
# macOS/Linux
claude mcp add --scope user dino -- npx dino-spec mcp serveThen restart Claude Code.
License
MIT
Built for developers who believe AI coding should be structured, reproducible, and context-aware.