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
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. Clone a Repository

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

Private Repositories

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

5. Start Chatting

  1. Select your cloned 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
/models List available models
/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
Ctrl+/ Toggle sidebar
Ctrl+K Command palette

Customize shortcuts in Settings > Keyboard Shortcuts.