opencode-skein — opencode, tuned for people who run their own models.
This is a fork. It tracks upstream opencode (the original "open source AI coding agent" — its README, translations, and most of the docs below are unmodified upstream content) but adds first-class support for a homelab full of local, GPU-hosted models. See CHANGELOG.md and
skein.jsonfor exactly what's fork-specific.
You want to run models from OpenRouter and local open-weight models on your own GPUs in your homelab, but you also want Claude Code — and Anthropic won't let you route their subscription through a third-party harness. You still want your agents to collaborate, and you're tired of both harnesses OOM-ing your GPUs independently because neither one knows the other exists.
opencode-skein + llama-skein let your agents share a fleet:
- llama-skein is the backend: a
llama.cpp/llama-swap-based server that runs on your GPU boxes, reports real VRAM/KV-cache capacity, and arbitrates who gets to load what. - opencode-skein (this repo) is the opencode side of that pairing — it finds your llama-skein
hosts on the LAN via mDNS, shows exactly what fits in VRAM before you try to load it, tracks
provider capacity/slot leases so concurrent agents don't double-book a host, and keeps long
unattended agent sessions (
/loop) running instead of quietly wedging. - Claude Code talks to the same fleet independently (it can't be routed through opencode), but because llama-skein is the shared source of truth for what's loaded and what's free, both harnesses can coexist on the same GPUs without stepping on each other.
If you don't run local models, plain upstream opencode is almost certainly what you want instead — this fork's value is entirely in the local-fleet layer.
curl -fsSL https://raw.githubusercontent.com/androidand/opencode-skein/dev/install | bashThis installs the latest opencode-skein GitHub Release. The Installation
section below is unmodified upstream content: its brew/npm/scoop/choco/nix/pacman
entries install upstream opencode, not this fork. Curl (above) is currently the only release
channel for opencode-skein itself — see CHANGELOG.md for what's shipped and
.github/workflows/skein-release.yml for how releases are cut.
Once installed, run opencode in a project directory, then /connect to find llama-skein hosts
on your LAN automatically, or add one manually. From there it behaves like upstream opencode —
see Agents and the upstream docs below for day-to-day use.
English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська | বাংলা | Ελληνικά | Tiếng Việt
# YOLO
curl -fsSL https://opencode.ai/install | bash
# Package managers
npm i -g opencode-ai@latest # or bun/pnpm/yarn
scoop install opencode # Windows
choco install opencode # Windows
brew install anomalyco/tap/opencode # macOS and Linux (recommended, always up to date)
brew install opencode # macOS and Linux (official brew formula, updated less)
sudo pacman -S opencode # Arch Linux (Stable)
paru -S opencode-bin # Arch Linux (Latest from AUR)
mise use -g opencode # Any OS
nix run nixpkgs#opencode # or github:anomalyco/opencode for latest dev branchTip
Remove versions older than 0.1.x before installing.
OpenCode is also available as a desktop application. Download directly from the releases page or opencode.ai/download.
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | opencode-desktop-mac-arm64.dmg |
| macOS (Intel) | opencode-desktop-mac-x64.dmg |
| Windows | opencode-desktop-windows-x64.exe |
| Linux | .deb, .rpm, or .AppImage |
# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktopThe install script respects the following priority order for the installation path:
$OPENCODE_INSTALL_DIR- Custom installation directory$XDG_BIN_DIR- XDG Base Directory Specification compliant path$HOME/bin- Standard user binary directory (if it exists or can be created)$HOME/.opencode/bin- Default fallback
# Examples
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bashOpenCode includes two built-in agents you can switch between with the Tab key.
- build - Default, full-access agent for development work
- plan - Read-only agent for analysis and code exploration
- Denies file edits by default
- Asks permission before running bash commands
- Ideal for exploring unfamiliar codebases or planning changes
Also included is a general subagent for complex searches and multistep tasks.
This is used internally and can be invoked using @general in messages.
Learn more about agents.
For more info on how to configure OpenCode, head over to our docs.
If you're interested in contributing to OpenCode, please read our contributing docs before submitting a pull request.
If you are working on a project that's related to OpenCode and is using "opencode" as part of its name, for example "opencode-dashboard" or "opencode-mobile", please add a note to your README to clarify that it is not built by the OpenCode team and is not affiliated with us in any way.