Browse docs

Quick Start

Get up and running with OpenCode Manager in minutes.

1. Start the Application

curl -fsSL https://opencodemanager.app/install | sh

Needs Docker with Compose v2. The installer asks before sharing anything from your machine, then starts the Manager. See Installation for each question.

Open http://localhost:5003

mkdir opencode-manager && cd opencode-manager
curl -fsSL https://raw.githubusercontent.com/chriswritescode-dev/opencode-manager/main/docker-compose.release.yml -o docker-compose.yml
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

3. Configure AI Provider

If you imported your OpenCode install with the installer, your providers are already connected and you can skip this step. Otherwise, configure at least one AI provider before chatting:

  1. Go to Settings (gear icon)
  2. Select Providers
  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
  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
  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.

5. Start Chatting

  1. Select your repository from the sidebar
  2. Click New Session or type /new
  3. Type your message
  4. Press Cmd+Enter (Ctrl+Enter on other platforms) to send, or Enter on mobile

Useful Commands

CommandDescription
/help, /settingsOpen settings
/new, /clearStart a new session
/sessions, /resume, /continueList and switch between sessions
/model, /modelsOpen the model picker, also while a response is running
/agentSwitch to the next primary agent
/variantsCycle the model's reasoning variant
/compactReduce session context
/rename [title]Rename the session; with no title, regenerate it
/forkFork the session from a chosen message, or the entire conversation
/timelineJump to a loaded message in the conversation
/btw <question>Ask a side question without adding it to the conversation
/copyCopy the full transcript as Markdown
/exportDownload the full transcript as Markdown
/undo, /redoUndo or redo the last message
/detailsToggle tool execution details
/mcpManage MCP servers
/skillsLoad a skill
/connectConnect a provider

Press Enter to run a command once its name is complete; use Shift+Enter to continue its text on a new line. Built-in commands use only the command text. Attached files and images are kept in the composer for your next message.

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

ShortcutAction
Cmd+Enter / Ctrl+EnterSend message
EnterRun a slash command, such as /btw <question>; otherwise a new line on desktop, send on mobile
Shift+EnterNew 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.