# 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.