This is a fork of opencode with fixes so I can self-host comfortably on a low-end device (Orange Pi).

When running opencode web inside a FUSE sandbox on the Pi:

• “Add project” path completion now feels instantaneous, down from 20+ seconds.
• Loading an uncached project now takes less than one second, down from 6+ seconds.
  • Note: configure enabled_providers to a small subset to fully benefit from this optimization.
• /assets/ URLs are now served as immutable, so browsers can cache them instead of re-downloading several MBs on every page load.

• The terminal endpoint no longer accepts authentication credentials through the URL.

• CJK input methods preserve IME composition in the prompt editor, including when Chrome starts composition from an empty draft.

• The GPT system prompt, including tool definitions, has been reduced from ~6k tokens to ~2k.

These fixes were present when this fork began, but upstream later implemented independent fixes for the same issues:

• Message ordering no longer depends on clock-derived ID ordering, preventing duplicate responses and ignored requests when clocks or IDs are out of order.

The opencode upstream appears to be overwhelmed by the volume of incoming PRs. I submitted polished fixes but received no response, so I decided to maintain a fork.

I use several coding agents, including kimi-code web, the Codex app, Zed, and opencode. My Git hook supports multiple tools.

• opencode: I like the context button tooltip showing the current cost, the ability to use different models for subagents, and the official OpenAI subscription support.
• kimi-code web: I like how it presents reasoning blocks: it shows only the final paragraph by default, with the full content available in a side panel.
• Codex: I like how it collapses intermediate details and shows only the final summary after each turn.

背景：我在 Orange Pi 上运行 opencode web，文件系统在 SD 卡上，并运行于 leash fuse 沙箱内，比普通机器慢许多。opencode 在打开未缓存的新项目时很慢（可能有 10 秒钟），比 kimi web（也在同一设备的沙箱内）慢很多。调查发现 opencode 在很多地方缺乏性能考虑，比如全项目或者全用户扫文件，多次跑没有太大意义的 git 命令，下载 models.dev 大 JSON 多次验证并做无用的序列化+反序列化等。

本 repo 最初修正了性能问题，使得 Pi 设备上运行相对流畅。后续包括了一些其他修改，如时差修正，输入法修正，以及提示词优化。

The open source AI coding agent.

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 branch

OpenCode is also available as a desktop application. Download directly from the releases page or opencode.ai/download.

# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktop

The install script respects the following priority order for the installation path:

1. $OPENCODE_INSTALL_DIR - Custom installation directory
2. $XDG_BIN_DIR - XDG Base Directory Specification compliant path
3. $HOME/bin - Standard user binary directory (if it exists or can be created)
4. $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 | bash

OpenCode 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.

Join our community Discord | X.com