claude-docs


Claude Code research workflow tool that auto-configures library-specific sub-agents via Context7.

Requirements: Claude Code CLI installed

Quick Start

``bash
cd your-project
npx claude-docs
claude /sync-docs
`

What It Does

claude-docs sets up your project for AI-powered documentation research:

1. Configures Context7 MCP server automatically
2. Installs slash commands (/sync-docs, /research)
3. Creates base research agents for codebase exploration

Then claude /sync-docs:
- Scans package.json / requirements.txt for dependencies
- Validates each library against Context7
- Generates @research-{library} agents with Context7 patterns

Installation

`bash
cd your-project
npx claude-docs
`

You'll be prompted for a Context7 API key (optional, increases rate limits).
Get one free at context7.com/dashboard.

This creates:
- .mcp.json - Context7 MCP server configuration
- .claude/commands/ - /sync-docs and /research commands
- .claude/agents/ - Base research agents

Usage

$3

After setup, run:

`bash
claude /sync-docs
`

This scans your dependencies and creates agents like:
- @research-react - React documentation specialist
- @research-stripe - Stripe documentation specialist
- @research-next - Next.js documentation specialist

$3

Direct invocation:
`
@research-react how do I use useEffect cleanup?
`

Via router:
`
/research stripe webhook signature verification
`

$3

Always available after setup:

| Agent | Purpose |
|-------|---------|
| @codebase-locator | Find WHERE code lives |
| @codebase-analyzer | Understand HOW code works |
| @codebase-pattern-finder | Find EXAMPLES in the codebase |
| @web-search-researcher | Research topics not in Context7 |

CLI Options

`
Usage: claude-docs [options]

Options:
-V, --version output the version number
--skip-mcp Skip Context7 MCP configuration
-h, --help display help for command
`

How It Works

$3

- Prompts for Context7 API key (optional)
- Runs claude mcp add to configure Context7 MCP server
- Creates .claude/commands/sync-docs.md and research.md
- Creates base agent templates in .claude/agents/

$3

- Reads package.json / requirements.txt
- Queries Context7 to validate each library
- Creates @research-{library} agents with Context7 search patterns
- Updates /research router with agent list

Context7 API Key

An API key is optional but increases rate limits.

Get one free: context7.com/dashboard

The key is stored in .mcp.json as a header for the Context7 MCP server.

Troubleshooting

$3

If you skipped MCP setup or it failed, configure manually:

`bash
claude mcp add --transport http --scope project context7 https://mcp.context7.com/mcp
`

With API key:
`bash
claude mcp add --transport http --scope project context7 https://mcp.context7.com/mcp \
--header "CONTEXT7_API_KEY: your-key"
`

$3

Not all libraries have Context7 coverage. The agent will be skipped.
Use @web-search-researcher` for libraries not in Context7.

$3

Get a free API key at context7.com/dashboard.

License

MIT