packages/cli/README.md
CLI for Context7 - 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.
# Run directly with npx (no install needed)
npx ctx7
# Or install globally
npm install -g ctx7
# Set up Context7 MCP for your coding agents
ctx7 setup
# Target a specific agent
ctx7 setup --cursor
ctx7 setup --claude
ctx7 setup --opencode
# 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"
# 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
Resolve a library name to a Context7 library ID.
ctx7 library react
ctx7 library nextjs "app router setup"
ctx7 library prisma "database relations"
# Output as JSON
ctx7 library react --json
Fetch documentation for a specific library using its Context7 ID.
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
Configure Context7 MCP and a rule for your AI coding agents. Authenticates via OAuth, generates an API key, and writes the config.
# 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
Generate custom skills tailored to your use case using AI. Requires authentication.
# 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:
Weekly generation limits apply: free accounts get 6 generations/week, Pro accounts get 10.
Log in to access skill generation and other authenticated features.
# Log in (opens browser for OAuth)
ctx7 login
# Check login status
ctx7 whoami
# Log out
ctx7 logout
Install skills from a project repository to your AI coding assistant's skills directory.
# 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
Find skills across all indexed projects in the registry.
ctx7 skills search pdf
ctx7 skills search typescript
ctx7 skills search react testing
View skills installed in your project or globally.
ctx7 skills list
ctx7 skills list --claude
ctx7 skills list --cursor
ctx7 skills list --universal
ctx7 skills list --global
Get details about available skills in a project.
ctx7 skills info /anthropics/skills
Uninstall a skill from your project.
ctx7 skills remove pdf
ctx7 skills remove pdf --claude
ctx7 skills remove pdf --universal
ctx7 skills remove pdf --global
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/ |
For faster usage, the CLI provides short aliases:
ctx7 si /anthropics/skills pdf # skills install
ctx7 ss pdf # skills search
ctx7 skills gen # skills generate
ctx7 skills g # skills generate
The CLI collects anonymous usage data to help improve the product. To disable telemetry, set the CTX7_TELEMETRY_DISABLED environment variable:
# 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
Visit context7.com to browse the skills registry and discover available skills.