🐙 Octocode CLI

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.

``bash
npx octocode-cli
`

---

📦 Installation & Usage

$3

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
`

$3

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.

`bash


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

`bash


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.

`bash


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.

`bash


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.

`bash


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:

`bash


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.