Getting Started

Get up and running with OpenCode agents in under 5 minutes.

Prerequisites

• OpenCode CLI installed
• Node.js/npm and Git
• Any project (existing repos work perfectly)

Quick Setup (60 seconds)

Via npx (Recommended)

# Global install
npx agents-opencode --global

# Project install
npx agents-opencode --project .

# Install with specific languages only
npx agents-opencode --global --languages python,typescript

# Update existing installation
npx agents-opencode --update

Via curl

Global Installation

curl -fsSL https://raw.githubusercontent.com/shahboura/agents-opencode/main/install.js \
  -o install.js && node install.js --global && rm install.js

Project Installation

curl -fsSL https://raw.githubusercontent.com/shahboura/agents-opencode/main/install.js \
  -o install.js && node install.js --project /path/to/your/project && rm install.js

Windows (PowerShell)

curl -fsSL https://raw.githubusercontent.com/shahboura/agents-opencode/main/install.js `
  -o install.js; node install.js --global; rm install.js

Uninstall

npx agents-opencode --uninstall

Your First Run

1. Open OpenCode:

   opencode
   

2. Initialize context:

   /init
   

3. Ask for help:

   @orchestrator Build a user authentication API with JWT tokens
   

What gets installed

• .opencode/ agent configs
• opencode.json project config

Notes

• AGENTS.md is created on first run or via /init.
• Coding standards in .opencode/instructions/ are available as reference for agents.

Next Steps

• Agents
• Coding Standards
• Commands & Skills
• Troubleshooting