Interactive CLI installer for octocode-mcp - Configure MCP servers for Cursor, Claude Desktop, and more
npm install octocode-cli


The unified installer and management hub for Octocode MCP servers and AI skills.
Website • Documentation • GitHub

Octocode CLI is the essential companion for AI-assisted development. It streamlines the installation of octocode-mcp, manages authentication across multiple AI clients, and keeps your MCP configurations synchronized.
---
- 🚀 One-Step Installation: Instantly configure octocode-mcp for Cursor, Claude Desktop, Windsurf, Zed, and more.
- 🔌 MCP Marketplace: Browse and install over 70+ community-vetted MCP servers directly from your terminal.
- 🧠 AI Skills Manager: Install and update specialized AI coding skills for Claude Code (research, local-search, implement, plan, pr-review, roast).
- 🔄 Universal Sync: Keep your MCP configurations and authentication states synchronized across all your IDEs.
- 🔐 Secure Authentication: Enterprise-grade token management with encrypted storage and multiple auth providers.
---
Get up and running in seconds. The interactive wizard will guide you through installation and authentication.
``bash`
npx octocode-cli
---
The recommended way to use Octocode CLI. Access all features through a unified menu:
| Menu Item | Description |
|-----------|-------------|
| 🐙 Octocode MCP | Install and configure Octocode MCP for your IDEs |
| 🐙 Octocode Skills | Install AI-powered research, planning & review skills |
| 🧠 Manage System Skills | Browse skills marketplace and manage installed skills |
| 🔑 Manage Auth | Sign in/out via Octocode OAuth or gh CLI |
| ⚡ Manage System MCP | Sync configs, browse MCP marketplace, inspect settings |
`bash`
npx octocode-cli
For automation and power users, Octocode CLI offers a comprehensive command-line interface.
#### 1. Install Octocode MCP
Install the GitHub MCP server for your preferred IDE.
`bashInteractive install
octocode-cli install
Supported IDEs:
cursor, claude-desktop, claude-code, windsurf, zed, vscode-cline, vscode-roo, vscode-continue, opencode, trae, antigravity#### 2. Manage Authentication
Securely authenticate with GitHub. Credentials are encrypted (AES-256-GCM) and stored in
~/.octocode/.`bash
Interactive login (OAuth device flow)
octocode-cli loginCheck authentication status
octocode-cli statusEnterprise Login
octocode-cli login --hostname github.mycompany.comSign out
octocode-cli logoutAuth management menu
octocode-cli auth
`#### 3. Get GitHub Token
Retrieve tokens for scripting or debugging.
`bash
Get token (auto: env → gh → octocode)
octocode-cli tokenGet token from specific source
octocode-cli token --type=octocode
octocode-cli token --type=ghShow token source and user info
octocode-cli token --sourceJSON output for scripting
octocode-cli token --json
`#### 4. Sync Configurations
Keep your MCP settings consistent across different editors.
`bash
Sync all IDEs
octocode-cli syncPreview changes (dry run)
octocode-cli sync --dry-runShow sync status
octocode-cli sync --statusForce sync (auto-resolve conflicts)
octocode-cli sync --force
`#### 5. Manage Skills
Install AI skills for Claude Code.
`bash
List available skills
octocode-cli skills listInstall all skills
octocode-cli skills installForce reinstall (overwrite existing)
octocode-cli skills install --force
`---
🖥️ Supported Clients
Octocode CLI supports a wide range of AI-first editors and tools.
| Client | Description | Config Location (macOS) |
|--------|-------------|-------------------------|
| Cursor | AI-first code editor |
~/.cursor/mcp.json |
| Claude Desktop | Anthropic's desktop app | ~/Library/Application Support/Claude/ |
| Windsurf | Codeium AI IDE | ~/.codeium/windsurf/mcp_config.json |
| Zed | High-performance editor | ~/.config/zed/settings.json |
| Claude Code | CLI Assistant | ~/.claude.json |
| Trae | Adaptive AI IDE | ~/Library/Application Support/Trae/mcp.json |
| Antigravity | Gemini-powered AI IDE | ~/.gemini/antigravity/mcp_config.json |
| Opencode | AI coding agent CLI | ~/.config/opencode/config.json |
| VS Code Extensions | Cline, Roo-Cline, Continue | (Varies by extension) |---
🔧 Troubleshooting
If you encounter issues, try the following commands:
`bash
Diagnose environment issues
npx node-doctorReset local credentials
rm -rf ~/.octocode && octocode-cli loginVerify auth status
octocode-cli status
`Common Issues:
- Token Expired: Run
octocode-cli login` to refresh credentials.---
This project is licensed under the PolyForm Small Business License 1.0.0.
Copyright © 2024 Octocode AI.