Installation Guide

Follow these steps to install the required tools and authenticate with GitHub Copilot.

Required Setup

1. Install Ghostty

Download and install Ghostty from:

https://ghostty.org/download

2. Install Homebrew

Run:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Install Opencode

Run:

brew install opencode

4. Log In with GitHub Copilot

Run:

opencode auth login

Then complete the login flow:

1. Select GitHub Copilot.
2. Open github.com.
3. Log in with your corporate account.
4. Authorize Opencode.

Optional Setup

Install oh-my-opencode

Install oh-my-opencode if you want better agent prompts.

Install Bun

oh-my-opencode requires Bun. Run:

curl -fsSL https://bun.sh/install | bash

Install oh-my-opencode

Run:

bunx oh-my-opencode install --no-tui --claude=no --gemini=no --openai=no --copilot=yes --opencode-zen=no

Review the model configuration

Review the generated config file at ~/.config/opencode/oh-my-opencode.json and check that all configured models use GitHub Copilot. Adjust the configuration if needed.

For more details about the available model setup options, see:

https://github.com/code-yeongyu/oh-my-openagent/blob/dev/docs/guide/installation.md#step-5-understand-your-model-setup

Upgrade

Upgrade Opencode

Run:

brew upgrade opencode

Upgrade oh-my-opencode

Run the same command used for installation:

bunx oh-my-opencode install --no-tui --claude=no --gemini=no --openai=no --copilot=yes --opencode-zen=no

Appendix

Suggested JSON for ~/.config/opencode/oh-my-opencode.json:

{
	"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/dev/assets/oh-my-opencode.schema.json",
	"agents": {
		"sisyphus": {
			"model": "github-copilot/claude-opus-4.6",
			"variant": "max"
		},
		"hephaestus": {
			"model": "github-copilot/gpt-5.3-codex",
			"variant": "medium"
		},
		"oracle": {
			"model": "github-copilot/gpt-5.4",
			"variant": "high"
		},
		"librarian": {
			"model": "github-copilot/claude-sonnet-4.6"
		},
		"explore": {
			"model": "github-copilot/gpt-5-mini"
		},
		"multimodal-looker": {
			"model": "github-copilot/gemini-3-flash-preview"
		},
		"prometheus": {
			"model": "github-copilot/claude-opus-4.6",
			"variant": "max"
		},
		"metis": {
			"model": "github-copilot/claude-opus-4.6",
			"variant": "max"
		},
		"momus": {
			"model": "github-copilot/gpt-5.4",
			"variant": "xhigh"
		},
		"atlas": {
			"model": "github-copilot/claude-sonnet-4.6"
		}
	},
	"categories": {
		"visual-engineering": {
			"model": "github-copilot/gemini-3.1-pro-preview",
			"variant": "high"
		},
		"ultrabrain": {
			"model": "github-copilot/gemini-3.1-pro-preview",
			"variant": "high"
		},
		"artistry": {
			"model": "github-copilot/gemini-3.1-pro-preview",
			"variant": "high"
		},
		"quick": {
			"model": "github-copilot/claude-haiku-4.5"
		},
		"unspecified-low": {
			"model": "github-copilot/claude-sonnet-4.6"
		},
		"unspecified-high": {
			"model": "github-copilot/claude-sonnet-4.6"
		},
		"writing": {
			"model": "github-copilot/gemini-3-flash-preview"
		}
	},
	"hashline_edit": true,
	"git_master": {
		"commit_footer": false,
		"include_co_authored_by": false
	}
}