@dhruv-413/opencode-pilot

Enterprise-grade AI-governed configuration for OpenCode CLI

🚀 Installation

Quick Install

npm install -g @dhruv-413/opencode-pilot

That's it! The package handles everything automatically.

📋 What Happens During Installation

When you run npm install -g @dhruv-413/opencode-pilot, here's the step-by-step process:

Step 1: NPM Downloads Package

┌─────────────────────────────────────────┐
│  npm installs @dhruv-413/opencode-pilot│
│  └── Downloads package from npm registry │
└─────────────────────────────────────────┘

Step 2: Dependencies Installation

┌─────────────────────────────────────────┐
│  npm installs dependencies:             │
│  ├── opencode-ai (core CLI)           │
│  ├── chalk (colored output)           │
│  ├── fs-extra (file operations)       │
│  ├── prompts (interactive prompts)    │
│  └── ... (other utilities)            │
└─────────────────────────────────────────┘

Step 3: Postinstall Script Runs (Automatic)

┌─────────────────────────────────────────┐
│  postinstall.js executes automatically: │
│  1. Welcome banner displayed          │
│  2. OpenCode CLI verified             │
│  3. Config directory detected          │
│  4. Installation type prompt           │
│  5. Files copied                      │
└─────────────────────────────────────────┘

Step 4: Configuration Directory Setup

┌─────────────────────────────────────────┐
│  Detected Paths:                       │
│  ├── Config: ~/.config/opencode/      │
│  ├── Data: ~/.local/share/opencode/   │
│  └── OS: darwin/linux/win32           │
└─────────────────────────────────────────┘

Step 5: Installation Type Selection

┌─────────────────────────────────────────┐
│  Choose Installation Type:              │
│                                         │
│  1. Full    - All components          │
│  2. Minimal - Core essentials          │
│  3. Custom - Choose what you want     │
│  4. Skip   - Configure later          │
└─────────────────────────────────────────┘

Step 6: Files Copied to ~/.config/opencode/

| Step | Files/Directories | Description | |------|-------------------|-------------| | 6.1 | opencode.json | Main MCP configuration | | 6.2 | AGENTS.md | Agent rules & instructions | | 6.3 | .env.example | Environment template | | 6.4 | agents/ | 14 AI agent definitions | | 6.5 | skills/ | 92+ skill packages | | 6.6 | commands/ | 16 slash commands | | 6.7 | governance/ | 8 rule files | | 6.8 | orchestration/ | 19 modules | | 6.9 | core/ | Model registry | | 6.10 | lib/ | Code utilities | | 6.11 | memory/ | Knowledge graph | | 6.12 | modes/ | Dev/Production modes | | 6.13 | templates/ | Project templates |

Step 7: API Keys Configuration (Optional)

┌─────────────────────────────────────────┐
│  Configure MCP Server Keys:             │
│                                         │
│  ✓ GitHub Personal Access Token        │
│  ✓ Firecrawl API Key                   │
│  ✓ Codacy Account Token                │
│                                         │
│  (Can also configure later in .env)   │
└─────────────────────────────────────────┘

Step 8: Installation Complete!

┌─────────────────────────────────────────┐
│  ✅ Installation Complete!               │
│                                         │
│  Next Steps:                           │
│  1. opencode                           │
│  2. /connect                           │
│  3. Select provider & enter key         │
│  4. Start coding!                      │
└─────────────────────────────────────────┘

🔧 Alternative Installation Methods

Using npx (without global install)

npx @dhruv-413/opencode-pilot

This will:

1. Download the package
2. Run the installation wizard
3. Copy configs to ~/.config/opencode/

📁 Installation Directory Structure

After installation, your system will have:

NPM Global Directory

$(npm config get prefix)/lib/node_modules/
└── @dhruv-413/
    └── opencode-pilot/
        ├── bin/           # CLI commands
        ├── scripts/       # Installation scripts
        ├── configs/       # Source config files
        ├── package.json
        └── ...

User Configuration Directory

~/.config/opencode/
├── opencode.json       # MCP configuration
├── AGENTS.md          # Agent rules
├── LICENSE            # MIT License
├── README.md          # Documentation
├── .env               # Your API keys
├── .env.example       # Template
├── agents/            # 14 AI agents
├── skills/            # 92+ skills
├── commands/          # 16 commands
├── governance/        # Rules
├── orchestration/     # Modules
├── core/              # Model registry
├── lib/               # Utilities
├── memory/            # Knowledge graph
├── modes/             # Dev/Prod
└── templates/         # Project templates

🔄 Updating

# Update to latest version
npm update -g @dhruv-413/opencode-pilot

# This will:
# 1. Download new version
# 2. Run postinstall
# 3. Update config files (keeps your .env)

🛠️ Manual Installation

If automatic installation fails:

# 1. Install package
npm install -g @dhruv-413/opencode-pilot

# 2. Manually copy configs
cp -r $(npm root -g)/@dhruv-413/opencode-pilot/configs/* ~/.config/opencode/

# 3. Create .env file
cp ~/.config/opencode/.env.example ~/.config/opencode/.env

# 4. Edit with your API keys
nano ~/.config/opencode/.env

🔑 API Keys Configuration

Option 1: During Installation

The installer prompts you to configure keys.

Option 2: After Installation

Edit ~/.config/opencode/.env:

# MCP Server Keys
GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxx
FIRECRAWL_API_KEY=fc_xxx
CODACY_ACCOUNT_TOKEN=xxx

# LLM Provider Keys (optional - can use /connect inside opencode)
# OPENAI_API_KEY=sk-xxx
# ANTHROPIC_API_KEY=sk-ant-xxx

⚠️ Troubleshooting

"Command not found" after install

# Add npm global bin to PATH
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Configuration not copied

# Re-run installation
npx @dhruv-413/opencode-pilot

opencode command not found

# Install opencode-ai separately
npm install -g opencode-ai

# Verify installation
opencode --version

📦 What's Included

| Component | Count | Description | |-----------|-------|-------------| | AI Agents | 14 | Planner, Security, DevOps, Architect, etc. | | Skills | 92+ | vitest, vue, fastapi, debugging, etc. | | MCP Servers | 16+ | GitHub, Git, SQLite, Firecrawl, etc. | | Commands | 16 | /plan, /fix, /test-gen, /review, etc. | | Governance Rules | 8 | Architecture, security, performance | | Orchestration | 19 | Workflow, waves, semantic routing |

🎯 Quick Start

1. Install

npm install -g @dhruv-413/opencode-pilot

The installer will ask:

• Full Installation - All components
• Minimal Installation - Core essentials
• Custom Selection - Choose what you want
• Skip for now - Configure later

2. Configure LLM Provider

opencode

Inside OpenCode:

/connect

Select your provider (OpenAI, Anthropic, Google, xAI, Groq, etc.) and enter your API key.

3. Start Coding

That's it! You now have:

• 14 specialized AI agents
• 92+ skills
• 16+ MCP servers
• Full governance and orchestration

🔧 CLI Commands

After installation, these commands are available:

| Command | Description | |---------|-------------| | opencode-pilot | Configure MCP server API keys | | opencode-pilot-config | View/manage configuration | | opencode-pilot-select | Select components to install |

Using npx (alternative)

npx @dhruv-413/opencode-pilot
npx @dhruv-413/opencode-pilot-config view
npx @dhruv-413/opencode-pilot-select

🌍 Environment Variables

| Variable | Description | Auto-Detected | |----------|-------------|----------------| | OPENCODE_USER_HOME | User home directory | ✅ Yes | | OPENCODE_CONFIG_DIR | Config directory | ✅ Yes | | OPENCODE_DATA_DIR | Data directory | ✅ Yes | | GITHUB_PERSONAL_ACCESS_TOKEN | GitHub PAT | ❌ Manual | | FIRECRAWL_API_KEY | Firecrawl key | ❌ Manual | | CODACY_ACCOUNT_TOKEN | Codacy token | ❌ Manual |

🖥️ OS Support

| OS | Config Directory | Data Directory | |----|-----------------|----------------| | Linux/macOS | ~/.config/opencode/ | ~/.local/share/opencode/ | | Windows | %USERPROFILE%\.config\opencode\ | %USERPROFILE%\.local\share\opencode\ |

📋 Requirements

• Node.js 18.0.0 or higher
• OpenCode CLI (installed automatically)

🤝 Support

• GitHub: github.com/Dhruv-413/opencode-pilot
• npm: npmjs.com/package/@dhruv-413/opencode-pilot
• OpenCode Docs: opencode.ai/docs

📄 License

MIT License - see LICENSE for details.

Version: 1.2.10
Last Updated: February 2026

Made with ❤️ by Dhruv