# ctx7

CLI for [Context7](https://context7.com) - query up-to-date library documentation and manage AI coding skills.

Skills are reusable prompt instructions that enhance your AI coding assistant with specialized capabilities like working with specific frameworks, libraries, or coding patterns.

## Installation

```bash
# Run directly with npx (no install needed)
npx ctx7

# Or install globally
npm install -g ctx7
```

## Quick Start

```bash
# Set up Context7 MCP for your coding agents
ctx7 setup

# Remove Context7 setup later
ctx7 remove

# Target a specific agent
ctx7 setup --cursor
ctx7 setup --claude
ctx7 setup --opencode
```

### Library Documentation

```bash
# Find a library
ctx7 library react
ctx7 library nextjs "app router"

# Get documentation
ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware"
```

### Skills

```bash
# Search for skills
ctx7 skills search pdf

# Install a skill
ctx7 skills install /anthropics/skills pdf

# Generate a custom skill with AI
ctx7 skills generate

# List installed skills
ctx7 skills list --claude
```

## Usage

### Find a library

Resolve a library name to a Context7 library ID.

```bash
ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"

# Output as JSON
ctx7 library react --json
```

### Query documentation

Fetch documentation for a specific library using its Context7 ID.

```bash
ctx7 docs /facebook/react "useEffect cleanup"
ctx7 docs /vercel/next.js "middleware authentication"
ctx7 docs /prisma/prisma "one-to-many relations"

# Output as JSON
ctx7 docs /facebook/react "hooks" --json
```

### Setup

Configure Context7 MCP and a rule for your AI coding agents. Authenticates via OAuth, generates an API key, and writes the config.

```bash
# Interactive (prompts for agent selection)
ctx7 setup

# Target specific agents
ctx7 setup --cursor
ctx7 setup --claude
ctx7 setup --opencode

# Use an existing API key instead of OAuth
ctx7 setup --api-key YOUR_API_KEY

# Use OAuth endpoint (IDE handles auth flow)
ctx7 setup --oauth

# Configure for current project only (default is global)
ctx7 setup --project

# Skip prompts
ctx7 setup --yes
```

### Uninstall setup

Remove the Context7 setup written by `ctx7 setup`. By default this removes both MCP setup and CLI setup for the selected agent.

```bash
# Interactive
ctx7 remove

# Target specific agents
ctx7 remove --cursor
ctx7 remove --claude --project

# Remove both setup modes explicitly
ctx7 remove --cursor --all

# Remove only one setup mode
ctx7 remove --cursor --cli
ctx7 remove --claude --mcp
```

If you installed the CLI itself globally with `npm install -g ctx7`, remove that separately with `npm uninstall -g ctx7`. If you use `npx ctx7`, there is no permanent CLI install to remove.

### Generate skills

Generate custom skills tailored to your use case using AI. Requires authentication.

```bash
# Log in first
ctx7 login

# Generate a skill (interactive)
ctx7 skills generate

# Short aliases
ctx7 skills gen
ctx7 skills g

# Generate and install to a specific client
ctx7 skills generate --cursor
ctx7 skills generate --claude
ctx7 skills generate --universal

# Generate globally
ctx7 skills generate --global
```

The generate flow:

1. Describe the expertise you want (e.g., "OAuth authentication with NextAuth.js")
2. Select relevant libraries from search results
3. Answer 3 clarifying questions to focus the skill
4. Review the generated skill, request changes if needed, then install

Weekly generation limits apply: free accounts get 6 generations/week, Pro accounts get 10.

### Authentication

Log in to access skill generation and other authenticated features.

```bash
# Log in (opens browser for OAuth)
ctx7 login

# Check login status
ctx7 whoami

# Log out
ctx7 logout
```

### Install skills

Install skills from a project repository to your AI coding assistant's skills directory.

```bash
# Install all skills from a project (interactive selection)
ctx7 skills install /anthropics/skills

# Install a specific skill
ctx7 skills install /anthropics/skills pdf

# Install multiple skills at once
ctx7 skills install /anthropics/skills pdf commit

# Install to a specific client
ctx7 skills install /anthropics/skills pdf --cursor
ctx7 skills install /anthropics/skills pdf --claude
ctx7 skills install /anthropics/skills pdf --universal

# Install globally (home directory instead of current project)
ctx7 skills install /anthropics/skills pdf --global

# Install non-interactively
ctx7 skills install /anthropics/skills pdf --global --universal --yes

# Install to all supported agent locations
ctx7 skills install /anthropics/skills pdf --all-agents
```

### Search for skills

Find skills across all indexed projects in the registry.

```bash
ctx7 skills search pdf
ctx7 skills search typescript
ctx7 skills search react testing
```

### List installed skills

View skills installed in your project or globally.

```bash
ctx7 skills list
ctx7 skills list --claude
ctx7 skills list --cursor
ctx7 skills list --universal
ctx7 skills list --global
```

### Show skill information

Get details about available skills in a project.

```bash
ctx7 skills info /anthropics/skills
```

### Remove a skill

Uninstall a skill from your project.

```bash
ctx7 skills remove pdf
ctx7 skills remove pdf --claude
ctx7 skills remove pdf --universal
ctx7 skills remove pdf --global
```

## Supported Clients

The CLI automatically detects which AI coding assistants you have installed and offers to install skills for them:

| Client                                                              | Skills Directory  |
| ------------------------------------------------------------------- | ----------------- |
| Universal (Amp, Codex, Gemini CLI, GitHub Copilot, OpenCode + more) | `.agents/skills/` |
| Claude Code                                                         | `.claude/skills/` |
| Cursor                                                              | `.cursor/skills/` |
| Antigravity                                                         | `.agent/skills/`  |

## Shortcuts

For faster usage, the CLI provides short aliases:

```bash
ctx7 si /anthropics/skills pdf   # skills install
ctx7 ss pdf                       # skills search
ctx7 skills gen                   # skills generate
ctx7 skills g                     # skills generate
```

## Disabling Telemetry

The CLI collects anonymous usage data to help improve the product. To disable telemetry, set the `CTX7_TELEMETRY_DISABLED` environment variable:

```bash
# For a single command
CTX7_TELEMETRY_DISABLED=1 ctx7 skills search pdf

# Or export in your shell profile (~/.bashrc, ~/.zshrc, etc.)
export CTX7_TELEMETRY_DISABLED=1
```

## Learn More

Visit [context7.com](https://context7.com) to browse the skills registry and discover available skills.
