Reading the repo

Opening the box…

How to set up opencode (anomalyco/opencode) · gitmanual

Assembly instructions

anomalyco/opencode

The open source coding agent.

Node.js

Difficulty: Moderate
Time: about 15 min
Stars: ★ 224,600
Activity: Updated this month
License: MIT
Open issues: 4,015
Got it running: Be the first
Looked up: 3 h ago

Saved setup from 3 h ago

Start here

Website ↗opencode.aiThe project's own site.

Setup script in the repo

The maintainers included install. Open it to see how it's meant to be run: install on GitHub.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

Download for macOS

v2.2.5 · 10/30/2026 ↗

opencode-desktop-mac-arm64.dmg

dmg · Apple Silicon · 329.6 MB · 1,635 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/anomalyco/opencode/releases/download/v2.2.5/opencode-desktop-mac-arm64.dmg"
open "opencode-desktop-mac-arm64.dmg"

Other macOS downloads (8)

opencode-darwin-arm64.zip

zip · Apple Silicon · 105.9 MB · 11,715 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/anomalyco/opencode/releases/download/v2.2.5/opencode-darwin-arm64.zip"
unzip "opencode-darwin-arm64.zip"

opencode-desktop-mac-arm64.zip

zip · Apple Silicon · 298.6 MB · 220 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/anomalyco/opencode/releases/download/v2.2.5/opencode-desktop-mac-arm64.zip"
unzip "opencode-desktop-mac-arm64.zip"

opencode-desktop-mac-x64.dmg

dmg · Intel · 344.2 MB · 230 downloads

Download

Drag the app into Applications.

curl -LO "https://github.com/anomalyco/opencode/releases/download/v2.2.5/opencode-desktop-mac-x64.dmg"
open "opencode-desktop-mac-x64.dmg"

opencode-desktop-mac-arm64.app.tar.gz

tar.gz · Apple Silicon · 298.4 MB · 155 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/anomalyco/opencode/releases/download/v2.2.5/opencode-desktop-mac-arm64.app.tar.gz"
tar -xzf "opencode-desktop-mac-arm64.app.tar.gz"

opencode-darwin-x64-baseline.zip

zip · Intel · 111.1 MB · 185 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/anomalyco/opencode/releases/download/v2.2.5/opencode-darwin-x64-baseline.zip"
unzip "opencode-darwin-x64-baseline.zip"

opencode-darwin-x64.zip

zip · Intel · 111.1 MB · 1,058 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/anomalyco/opencode/releases/download/v2.2.5/opencode-darwin-x64.zip"
unzip "opencode-darwin-x64.zip"

opencode-desktop-mac-x64.zip

zip · Intel · 310.8 MB · 148 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/anomalyco/opencode/releases/download/v2.2.5/opencode-desktop-mac-x64.zip"
unzip "opencode-desktop-mac-x64.zip"

opencode-desktop-mac-x64.app.tar.gz

tar.gz · Intel · 310.7 MB · 121 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/anomalyco/opencode/releases/download/v2.2.5/opencode-desktop-mac-x64.app.tar.gz"
tar -xzf "opencode-desktop-mac-x64.app.tar.gz"

Install with a package manager

install script

curl -fsSL https://opencode.ai/v2/install | bash

Pipes a remote script into your shell. Read it before running.

Homebrew

brew install anomalyco/tap/opencode-v2 # macOS and Linux (recommended, always up to date)

Homebrew

brew install opencode              # macOS and Linux (official brew formula, updated less)

Nix

nix run github:anomalyco/opencode  # Nix

Homebrew

brew install --cask opencode-desktop

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 9 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js 24runtime
1×Bun runtime
1×bun bun@1.4.4package manager

Share this manual

Good to know

Monorepo (workspaces) — install from the repo root.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: packages/ai/package.json, packages/app/package.json, packages/cli/package.json, packages/client/package.json and 11 more

package.json scripts (27)

devbun run --cwd packages/cli src/index.ts
dev:livesh -c 'OPENCODE_TUI_CHANNEL=dev OPENCODE_PASSWORD="$(opencode service get password)" exec bun run dev "$@" --server "$(opencode service status)"' --
dev:vitebun run --cwd packages/cli --conditions=browser dev/vite.ts
dev:vite:livesh -c 'OPENCODE_TUI_CHANNEL=dev OPENCODE_PASSWORD="$(opencode service get password)" exec bun run dev:vite "$@" --server "$(opencode service status)"' --
dev:desktopbun --cwd packages/desktop dev
dev:webbun --cwd packages/app dev
dev:consoleulimit -n 10240 2>/dev/null; bun run --cwd packages/console/app dev
dev:statsbun sst shell --stage=production -- bun run --cwd packages/stats/app dev
dev:wwwbun run --cwd services/www dev
lintoxlint && ast-grep scan -c script/ast-grep/gui-plugins/sgconfig.yml && bun script/sdk-docs.ts
lint:changedbun script/lint-changed.ts
lint:effect-patternsast-grep scan -c script/ast-grep/sgconfig.yml packages/util/src packages/core/src packages/server/src packages/protocol/src packages/cli/src
lint:effect-simplificationsast-grep scan -c script/ast-grep/effect-simplifications/sgconfig.yml --off=unused-suppression packages
test:lint-rulesast-grep test -c script/ast-grep/sgconfig.yml
test:effect-simplification-rulesast-grep test -c script/ast-grep/effect-simplifications/sgconfig.yml
typecheckbun turbo typecheck --concurrency=3
typecheck:tscbun turbo typecheck:tsc --concurrency=3
checkbun run lint && bun run typecheck
typecheck:profilebun script/profile-typecheck.ts
typecheck:profile:packagesbun script/profile-typecheck-packages.ts
packbun run script/pack.ts
upgrade-opentuibun run script/upgrade-opentui.ts
postinstallbun run --cwd packages/core fix-node-pty
preparehusky
randomecho 'Random script'

Files we read (9)

.github/workflows/bot-docs-locale.yml

.github/workflows/check-bot-scope.yml

.github/workflows/check-nix.yml

.github/workflows/check-process-daemon.yml

.github/workflows/check-test.yml

.github/workflows/check.yml

CONTRIBUTING.md

README.md

package.json

Branch dev · 9,347 files in the repo