Installation
Install OrchestKit in Claude Code — marketplace, CLI, or manual setup.
From Claude Code Marketplace (Recommended)
claude install orchestkit/orkThis installs all 103 skills, 36 agents, and 146 hooks.
Interactive Setup
Verify Installation
Run the health check after installing:
/ork:doctorExpected output:
OrchestKit Health Check
=======================
Plugin: ork v7.24.0
Skills: 100 loaded (21 commands, 79 reference)
Agents: 35 registered
Hooks: 109 active (40 global, 47 agent, 22 skill-scoped)
Memory: Graph ✓ Local ✓ CC Native ✓
MCP: context7 ✓ memory ✓ tavily ○ agentation ○
Status: Healthy○ means optional and not configured. ✓ means active. ✗ means enabled but misconfigured.
If You See Errors
| Status | Meaning | Fix |
|---|---|---|
✗ Memory: Graph ✗ | MCP memory server not responding | Check Node.js >= 18 is installed, restart Claude Code |
✗ Hooks: 0 active | Hook compilation failed | Run node --version (must be >= 18). If OK, reinstall: claude uninstall ork && claude install orchestkit/ork |
✗ Skills: 0 loaded | Plugin not found by Claude Code | Check claude plugins shows ork. Try closing and reopening Claude Code |
○ tavily ○ | Not an error — Tavily is optional | See setup below if you want web research |
○ agentation ○ | Not an error — Agentation is optional | Only needed for UI annotation workflows |
Most issues are fixed by ensuring Node.js >= 18 is installed and restarting Claude Code. If problems persist, run /ork:doctor --verbose for detailed diagnostics.
Optional: Web Research (Tavily)
OrchestKit works out of the box with all 3 memory tiers (Graph, Local, CC Native). For enhanced web research, enable the Tavily MCP:
1. Get a free API key at app.tavily.com (1,000 credits/month free)
2. Set the key in your shell profile (~/.zshrc or ~/.bashrc):
export TAVILY_API_KEY="tvly-your-key-here"3. Enable the MCP in .mcp.json:
"tavily": {
"command": "sh",
"args": ["-c", "TAVILY_API_KEY=${TAVILY_API_KEY} exec npx -y tavily-mcp@latest"],
"disabled": false
}Without Tavily, web research falls back to WebFetch → agent-browser automatically.
Requirements
- Claude Code >= 2.1.84
- Node.js >= 18 (for hooks)
- Git (for commit/PR workflows)
Next Steps
Last updated on