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

✨ Key Features

• 🚀 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.

🚀 Quick Start

Get up and running in seconds. The interactive wizard will guide you through installation and authentication.

npx octocode-cli

📦 Installation & Usage

Interactive Mode

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 |

npx octocode-cli

CLI Commands

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.

# Interactive install
octocode-cli install

# Specific IDEs
octocode-cli install --ide cursor --method npx
octocode-cli install --ide claude-desktop --method direct
octocode-cli install --ide windsurf
octocode-cli install --ide zed

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

# Interactive login (OAuth device flow)
octocode-cli login

# Check authentication status
octocode-cli status

# Enterprise Login
octocode-cli login --hostname github.mycompany.com

# Sign out
octocode-cli logout

# Auth management menu
octocode-cli auth

3. Get GitHub Token

Retrieve tokens for scripting or debugging.

# Get token (auto: env → gh → octocode)
octocode-cli token

# Get token from specific source
octocode-cli token --type=octocode
octocode-cli token --type=gh

# Show token source and user info
octocode-cli token --source

# JSON output for scripting
octocode-cli token --json

4. Sync Configurations

Keep your MCP settings consistent across different editors.

# Sync all IDEs
octocode-cli sync

# Preview changes (dry run)
octocode-cli sync --dry-run

# Show sync status
octocode-cli sync --status

# Force sync (auto-resolve conflicts)
octocode-cli sync --force

5. Manage Skills

Install AI skills for Claude Code.

# List available skills
octocode-cli skills list

# Install all skills
octocode-cli skills install

# Force 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:

# Diagnose environment issues
npx node-doctor

# Reset local credentials
rm -rf ~/.octocode && octocode-cli login

# Verify auth status
octocode-cli status

Common Issues:

• Token Expired: Run octocode-cli login to refresh credentials.
• Browser Not Opening: Copy the authorization URL manually from the terminal.

📄 License

This project is licensed under the PolyForm Small Business License 1.0.0.

Copyright © 2024 Octocode AI.