---
title: Installation
description: Install OrchestKit in Claude Code — marketplace, CLI, or manual setup.
---

import { Card, Cards } from 'fumadocs-ui/components/card';
import { Callout } from 'fumadocs-ui/components/callout';
import { LazySetupWizard } from '@/components/lazy';

## From Claude Code Marketplace (Recommended)

```bash
claude install orchestkit/ork
```

This installs all 111 skills, 37 agents, and 202 hooks.

## Interactive Setup

<LazySetupWizard />

## Verify Installation

Run the health check after installing:

```
/ork:doctor
```

Expected output:

```
OrchestKit Health Check
=======================
Plugin:     ork v7.43.0
Skills:     107 loaded (27 commands, 80 reference)
Agents:     37 registered
Hooks:      202 active (134 global, 46 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 |

<Callout type="info">
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.
</Callout>

## 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](https://app.tavily.com) (1,000 credits/month free)

**2. Set the key** in your shell profile (`~/.zshrc` or `~/.bashrc`):

```bash
export TAVILY_API_KEY="tvly-your-key-here"
```

**3. Enable the MCP** in `.mcp.json`:

```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.108
- **Node.js** >= 18 (for hooks)
- **Git** (for commit/PR workflows)

## Next Steps

<Cards>
  <Card title="First 10 Minutes" href="/docs/getting-started/first-10-minutes" description="Guided walkthrough of your first session" />
  <Card title="Configuration" href="/docs/getting-started/configuration" description="Full environment setup" />
</Cards>
