Skip to content

Quick Start

Get up and running with OpenCode Manager in minutes.

1. Start the Application

git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager
cp .env.example .env
echo "AUTH_SECRET=$(openssl rand -base64 32)" >> .env
docker-compose up -d

Open http://localhost:5003

git clone https://github.com/chriswritescode-dev/opencode-manager.git
cd opencode-manager
pnpm install
cp .env.example .env
pnpm dev

Open http://localhost:5173

2. Create Admin Account

On first launch, you'll be redirected to the setup page:

  1. Enter your name
  2. Enter your email
  3. Create a password
  4. Click Create Account

Pre-configured Admin

For automated deployments, you can skip this step by setting ADMIN_EMAIL and ADMIN_PASSWORD environment variables.

3. Configure AI Provider

Before chatting, you need to configure at least one AI provider:

  1. Go to Settings (gear icon)
  2. Select Provider Credentials
  3. Choose a provider (e.g., Anthropic, OpenAI)
  4. Enter your API key or click Add OAuth for supported providers
  5. Click Save

4. Add Repositories

Choose the onboarding flow that matches your setup:

Clone a Remote Repository

  1. Click the folder icon in the sidebar
  2. Click Add Repository
  3. Select Remote Repository
  4. Paste a repository URL (HTTPS or SSH)
  5. Click Add Repository

Discover Existing Local Repositories

  1. Click the folder icon in the sidebar
  2. Click Add Repository
  3. Select Folder Discovery
  4. Enter a parent folder such as /Users/you/Development
  5. Click Discover Repositories

If you already used standalone OpenCode in those repositories, existing chats appear as soon as the discovered repo path matches the original OpenCode path.

Private Repositories

For private repos, configure a GitHub Personal Access Token in Settings > Credentials first.

5. Start Chatting

  1. Select your repository from the sidebar
  2. Click New Session or type /new
  3. Type your message
  4. Press Enter to send

Useful Commands

Command Description
/help Show available commands
/new Start a new session
/compact Reduce session context

File Mentions

Reference files in your prompts:

  1. Type @ in the chat input
  2. Start typing a filename
  3. Select from the autocomplete dropdown
  4. The AI will have access to that file's contents

6. Explore Features

Now that you're set up, explore more features:

Keyboard Shortcuts

Shortcut Action
Enter Send message
Shift+Enter New line

The app uses a configurable leader key system (Cmd+O on Mac, Ctrl+O on other platforms) for additional shortcuts. Customize in Settings > Keyboard Shortcuts.