Community fork of OpenCode adding an integrated terminal and a persistent usage dashboard. Not affiliated with the OpenCode team.
OpenCode Rig — an unofficial fork of the open source AI coding agent.
github.com/toshon-jennings/opencode-rig
[!IMPORTANT] This is an unofficial community fork. It is not built, maintained, endorsed, or supported by the OpenCode team, and it is not affiliated with them in any way.
Please do not file issues about this fork on the upstream tracker, and do not ask the OpenCode maintainers for support with it. Report problems with this fork at toshon-jennings/opencode-rig/issues.
For the official project, see opencode.ai and anomalyco/opencode. "OpenCode" and the OpenCode logo belong to their respective owners; the mark above is a modified version used only to distinguish this fork.
A panel pinned across the bottom of the session view, reporting per model: messages, input / output / reasoning tokens, cache reads and writes, and cost — plus a TOTAL row.
- Always visible. No toggle, keybind, or slash command — it is part of the session layout, like the message timeline or the prompt input.
- Live. Refreshes every 30 seconds and on mount, with a last-updated stamp in the header and a manual Refresh button.
- Resizable. Drag its top edge; the height persists across restarts.
- Quiet on failure. If the underlying command is missing or errors, the panel shows a muted message instead of breaking the session view.
- Desktop only. Web builds render nothing, since the panel needs local command execution.
A terminal available directly in the session view, kept alongside the usage dashboard in the same layout so you can run commands without leaving the conversation.
The dashboard shells out to packages/desktop/resources/opencode-usage, which ships with this repository — a fresh clone works with no extra setup. It reads the local OpenCode database at ~/.local/share/opencode/opencode.db (override with $OPENCODE_DB) and needs the sqlite3 binary on your system.
If that bundled script is missing, the app falls back to any opencode-usage on your login shell's PATH. If neither resolves, the panel renders a muted error and nothing else breaks.
To substitute your own, print a sqlite3 -header -column style table with exactly these eight columns, one row per model plus a TOTAL row:
model msgs input output reasoning cache_read cache_write cost
This fork versions independently of upstream, starting at 0.1.0. Upstream is on the 1.18.x line, so there is no overlap and no ambiguity about which project a given version refers to. The upstream release this fork is currently rebased on is recorded as upstreamBase in the root package.json.
Releases and the desktop auto-updater resolve against this fork's releases — never upstream's.
Everything else is upstream OpenCode. See upstream's docs for the underlying feature set.
---
brew install toshon-jennings/tap/oc-rigOr tap first, then install:
brew tap toshon-jennings/tap
brew install --cask oc-rigThen launch OpenCode Rig from your Applications folder (or Spotlight).
Clone this repository and build from source — see CONTRIBUTING.md.
[!TIP] 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.
PlatformDownloadmacOS (Apple Silicon)opencode-desktop-mac-arm64.dmgmacOS (Intel)opencode-desktop-mac-x64.dmgWindowsopencode-desktop-windows-x64.exeLinux.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 Docs.
If you're interested in contributing to OpenCode (not this fork), please read 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 the OpenCode community Discord | X.com
Community fork of OpenCode adding an integrated terminal and a persistent usage dashboard. Not affiliated with the OpenCode team.
OpenCode Rig — an unofficial fork of the open source AI coding agent.
github.com/toshon-jennings/opencode-rig
[!IMPORTANT] This is an unofficial community fork. It is not built, maintained, endorsed, or supported by the OpenCode team, and it is not affiliated with them in any way.
Please do not file issues about this fork on the upstream tracker, and do not ask the OpenCode maintainers for support with it. Report problems with this fork at toshon-jennings/opencode-rig/issues.
For the official project, see opencode.ai and anomalyco/opencode. "OpenCode" and the OpenCode logo belong to their respective owners; the mark above is a modified version used only to distinguish this fork.
A panel pinned across the bottom of the session view, reporting per model: messages, input / output / reasoning tokens, cache reads and writes, and cost — plus a TOTAL row.
- Always visible. No toggle, keybind, or slash command — it is part of the session layout, like the message timeline or the prompt input.
- Live. Refreshes every 30 seconds and on mount, with a last-updated stamp in the header and a manual Refresh button.
- Resizable. Drag its top edge; the height persists across restarts.
- Quiet on failure. If the underlying command is missing or errors, the panel shows a muted message instead of breaking the session view.
- Desktop only. Web builds render nothing, since the panel needs local command execution.
A terminal available directly in the session view, kept alongside the usage dashboard in the same layout so you can run commands without leaving the conversation.
The dashboard shells out to packages/desktop/resources/opencode-usage, which ships with this repository — a fresh clone works with no extra setup. It reads the local OpenCode database at ~/.local/share/opencode/opencode.db (override with $OPENCODE_DB) and needs the sqlite3 binary on your system.
If that bundled script is missing, the app falls back to any opencode-usage on your login shell's PATH. If neither resolves, the panel renders a muted error and nothing else breaks.
To substitute your own, print a sqlite3 -header -column style table with exactly these eight columns, one row per model plus a TOTAL row:
model msgs input output reasoning cache_read cache_write cost
This fork versions independently of upstream, starting at 0.1.0. Upstream is on the 1.18.x line, so there is no overlap and no ambiguity about which project a given version refers to. The upstream release this fork is currently rebased on is recorded as upstreamBase in the root package.json.
Releases and the desktop auto-updater resolve against this fork's releases — never upstream's.
Everything else is upstream OpenCode. See upstream's docs for the underlying feature set.
---
brew install toshon-jennings/tap/oc-rigOr tap first, then install:
brew tap toshon-jennings/tap
brew install --cask oc-rigThen launch OpenCode Rig from your Applications folder (or Spotlight).
Clone this repository and build from source — see CONTRIBUTING.md.
[!TIP] 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.
PlatformDownloadmacOS (Apple Silicon)opencode-desktop-mac-arm64.dmgmacOS (Intel)opencode-desktop-mac-x64.dmgWindowsopencode-desktop-windows-x64.exeLinux.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 Docs.
If you're interested in contributing to OpenCode (not this fork), please read 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.