Reading the repo

Opening the box…

How to install opencode on macOS (anomalyco/opencode) · gitmanual

How to install on macOS

anomalyco/opencode

The open source coding agent.

Node.js

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

Saved setup from 7 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

macOS Windows Linux

Download for macOS

process-daemon v0.5.0 · 11/5/2026 ↗

opencode-pty-0.5.0-aarch64-apple-darwin.tar.gz

tar.gz · Apple Silicon · 1.2 MB · 26 downloads · best match

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/process-daemon-v0.5.0/opencode-pty-0.5.0-aarch64-apple-darwin.tar.gz"
tar -xzf "opencode-pty-0.5.0-aarch64-apple-darwin.tar.gz"

Other macOS downloads (1)

opencode-pty-0.5.0-x86_64-apple-darwin.tar.gz

tar.gz · Intel · 1.2 MB · 33 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/process-daemon-v0.5.0/opencode-pty-0.5.0-x86_64-apple-darwin.tar.gz"
tar -xzf "opencode-pty-0.5.0-x86_64-apple-darwin.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? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

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

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/anomalyco/opencode/badge.svg)](https://gitmanual.com/anomalyco/opencode)

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:sitebun run --cwd services/site 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/check-bot-scope.yml

.github/workflows/check-docs.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 · 11,395 files in the repo