An open source fork of OpenCode — the AI coding agent.
Built with 💐 for the original OpenCode team and community
JonsOC is a community fork of OpenCode, the incredible open-source AI coding agent created by the OpenCode team. This fork is maintained independently with additional features and enhancements while staying true to the original vision.
- To add platform-specific enhancements (Windows Terminal clipboard support, etc.)
- To provide an alternative distribution channel
- To experiment with additional features while the upstream project evolves
- To ensure continued open-source availability
This project would not exist without the amazing work of the OpenCode team and contributors. We are deeply grateful for their groundbreaking work in open-source AI coding assistants.
- Original Project: OpenCode
- Original Website: opencode.ai
- License: MIT (same as original)
Please consider supporting the original OpenCode project!
Important
Enhanced features in this fork:
- Clipboard image paste (Windows Terminal) — Fixes image paste failing by pulling image data into the prompt.
- Double-press
escto clear — Prevents accidental prompt wipes while keeping a quick clear path.
jonsocruns the JonsOC build from this repo, using your current directory as the project- From the repo root it runs
bun run dev, elsewhere it uses the installed build - It auto-rebuilds when sources are newer than the last built binary
- Use
jonsoc -buildorjonsoc --buildto force a rebuild - Use
jonsoc -safeto run the latest npm release (jonsoc@latest) instead of the local build- Set
JONSOC_SAFE_ISOLATE=1(or pass-safe-isolated) to keep safe mode config/state separate
- Set
- Use
jonsoc -checkto printrunningand exit without launching the UI - Use
jonsoc -restartto relaunch and reattach to the most recent session - Windows note: rebuild can fail if
jonsoc.exeis still running (file lock), so close any JonsOC instance before forcing a rebuild
# YOLO
curl -fsSL https://jonsoc.com/install | bash
# Package managers
npm i -g jonsoc@latest # or bun/pnpm/yarn
scoop install jonsoc # Windows
choco install jonsoc # Windows
brew install anomalyco/tap/jonsoc # macOS and Linux (recommended, always up to date)
brew install jonsoc # macOS and Linux (official brew formula, updated less)
paru -S jonsoc-bin # Arch Linux
mise use -g jonsoc # Any OS
nix run nixpkgs#jonsoc # or github:anomalyco/jonsoc for latest dev branchTip
Remove versions older than 0.1.x before installing.
JonsOC is also available as a desktop application. Download directly from the releases page or jonsoc.com/download.
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | jonsoc-desktop-darwin-aarch64.dmg |
| macOS (Intel) | jonsoc-desktop-darwin-x64.dmg |
| Windows | jonsoc-desktop-windows-x64.exe |
| Linux | .deb, .rpm, or AppImage |
# macOS (Homebrew)
brew install --cask jonsoc-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/jonsoc-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 exists or can be created)$HOME/.jonsoc/bin- Default fallback
# Examples
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://jonsoc.com/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://jonsoc.com/install | bashJonsOC 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 JonsOC head over to our docs.
If you're interested in contributing to JonsOC, please read our contributing docs before submitting a pull request.
If you are working on a project that's related to JonsOC and is using "jonsoc" as a part of its name; for example, "jonsoc-dashboard" or "jonsoc-mobile", please add a note to your README to clarify that it is not built by the JonsOC team and is not affiliated with us in any way.
It's very similar to Claude Code in terms of capability. Here are the key differences:
- 100% open source
- Not coupled to any provider. Although we recommend the models we provide through JonsOC Zen; JonsOC can be used with Claude, OpenAI, Google or even local models. As models evolve the gaps between them will close and pricing will drop so being provider-agnostic is important.
- Out of the box LSP support
- A focus on TUI. JonsOC is built by neovim users and the creators of terminal.shop; we are going to push the limits of what's possible in the terminal.
- A client/server architecture. This for example can allow JonsOC to run on your computer, while you can drive it remotely from a mobile app. Meaning that the TUI frontend is just one of the possible clients.