English · 简体中文 · 日本語 · 한국어 · हिन्दी
One plugin that gives OpenCode Desktop computer use, a provider editor, ready-made agents and automation.
Your OpenCode agent can now use your computer, any model provider, and a schedule.
Install in one prompt · Screenshots · Report a bug
Quick start · How it works · What it adds · Highlights · FAQ · Build from source
Important
Get OpenCode Mod only from Subhashis360/opencode-mod. It is an unofficial community extension, not made by the OpenCode team. The old standalone "OpenCode Mod" desktop app is discontinued: uninstall it and use this extension inside the official OpenCode app.
Want OpenCode to do more than edit code? Add this extension and its agent can open and control your desktop apps and Android phone. It can also use any OpenAI-compatible provider, with the model list fetched for you, and run prompts on a schedule while you're away.
OpenCode Mod is a plugin for the official OpenCode Desktop app. It adds a Settings → Mod page with twelve tabs, so agents, providers, MCP servers, permissions, hooks and memory are set up with forms instead of hand-edited JSON. Everything is saved in your normal OpenCode config, keeps working without the extension, and runs locally on your computer.
You need OpenCode Desktop 2.2 or newer and Git. Computer use needs Windows; everything else works on Windows, macOS and Linux. The built files ship in the repository, so there is nothing to compile.
Paste this into any coding agent that can run commands on your computer: OpenCode, Claude Code, Codex, Cursor, Gemini CLI and others.
Install the OpenCode Mod extension for OpenCode Desktop from https://github.com/Subhashis360/opencode-mod
1. Check that git is installed. Clone the repository into a permanent folder in my home directory
(for example ~/opencode-mod). If that folder already exists and is this repository, run `git pull` in it instead.
2. Open my global OpenCode config: ~/.config/opencode/opencode.json
(on Windows: C:\Users\<me>\.config\opencode\opencode.json). Create the file with {} if it does not exist.
3. Add the absolute path of the cloned folder, written with forward slashes, to the "plugins" array
(create the array if it is missing). Keep every other setting and every existing plugin exactly as it is,
keep the file valid JSON/JSONC, and do not add the path twice.
4. Do not change anything else. Do not run npm install: the built files are already in the repository.
5. Show me the "plugins" line you wrote, then tell me to restart OpenCode Desktop (2.2 or newer)
and open Settings → Mod, or press Ctrl+Shift+P and type "Mod".
git clone https://github.com/Subhashis360/opencode-mod.gitAdd the cloned folder to plugins in your global OpenCode config, ~/.config/opencode/opencode.json (on Windows C:\Users\<you>\.config\opencode\opencode.json):
Use forward slashes on Windows too, and keep any plugins you already have. Restart OpenCode Desktop and open Settings → Mod, or press Ctrl+Shift+P and type Mod.
The extension updates itself: each time OpenCode starts it checks this repository and installs an update in the background, then asks for a restart. Turn that off, or check and update with one click, in Mod → Updates. git pull in the folder still works. To uninstall, remove the line from plugins and restart OpenCode. Your settings stay in your config and do nothing on their own.
OpenCode Desktop 2.2 loads plugins listed in the global opencode.json. OpenCode Mod has two parts:
| Part | Runs in | What it does |
|---|---|---|
Server part (dist/server.js) |
OpenCode's local server | Adds the computer, schedule and memory tools, the hooks, the screenshot clean-up, and the API the settings page calls |
Desktop part (dist/gui-experimental.cjs) |
OpenCode Desktop's windows and main process | Adds the Settings → Mod page and commands, the tray icon, and the runner that starts scheduled tasks |
You talk to your agent as usual. When it needs your desktop it calls the computer tool, asks you before touching each app, and works through Windows UI Automation and OCR before falling back to screenshots. Settings you change in Mod are written to your OpenCode config, so OpenCode and the agent pick them up on the next message.
| Group | Tab | What you get |
|---|---|---|
| Agent | Agents | Custom agents with their own prompt, model, color and tool limits, from templates such as Security Auditor and Bug Bounty Assistant |
| System prompt | The exact prompt OpenCode gives each model, editable per agent, plus your own prompt library | |
| Commands | Custom slash commands with a prompt, agent and model (/review, /audit, /tests, /fix templates) |
|
| Memory | Facts the agent saves about you and each project, added to every new session | |
| Tools | MCP servers | Local or remote MCP servers with a form (Playwright, Context7, GitHub, Filesystem templates) |
| Computer use | The agent sees and controls Windows apps and Android phones, with per-app approval | |
| Hooks | Your shell commands before or after tool calls, on prompts, on idle and on errors | |
| Permissions | Presets (Read-only audit, Safe, Balanced, Full auto) and per-tool allow / ask / deny | |
| Models | Providers | Edit custom providers and fetch their models from the provider's API |
| Session limits | Your free-model usage today and over the last week | |
| Automation and speed | Scheduled | Prompts that run once, every N minutes, daily, weekly, monthly or on a cron, with notifications |
| Experimental | Parallel web search, warm sessions, background compaction and other speed settings |
OpenCode's own Providers page can only rename or remove a provider. Mod → Providers (or Edit custom providers in the command palette) edits the base URL, API key, headers and AI SDK package of any OpenAI-compatible provider, and fetches its model list so you only tick the models you want. It has templates for OpenRouter, Ollama, LM Studio, NVIDIA NIM and Together. Fetching uses the key you typed or the one you already connected in OpenCode, and runs through OpenCode's local server, so the provider's CORS rules don't block it.
The agent opens apps, reads windows, clicks, types and checks its own work, on Windows and on Android phones over adb. It reads windows as numbered text first, which is faster and works with text-only models. With Don't use my cursor on, it presses buttons through accessibility while you keep using your mouse. A glow outlines the app it is using and disappears when the run ends. Screenshot files are deleted as soon as they are read, and older screenshots are dropped from the conversation so every step stays quick.
Security Auditor reviews code for vulnerabilities without changing it and reports each finding with severity, location and fix. Bug Bounty Assistant is for authorized pentests, bug bounty programs and CTFs: it plans recon and test cases, builds minimal proofs of concept and writes findings in report format, asking before it runs commands. Code Reviewer, Debugger, Test Writer, Architect and Docs Writer cover everyday work.
Mod → Experimental → Speed brings together the settings that make OpenCode respond faster. You can switch web search to Parallel, Exa or Tavily, or rotate between them when one is rate limited. You can also keep recent sessions' prompt caches warm, summarize long chats in the background, turn off undo snapshots in big projects, store media compactly, and cap tool output.
Is this an OpenCode extension or a separate app?
An extension. It is a plugin package that OpenCode Desktop 2.2+ loads from your config, with a server part and a desktop part. The old standalone OpenCode Mod app is discontinued.
How do I install a plugin in OpenCode Desktop?
Add the plugin's folder or package to plugins in your global opencode.json and restart the app. See Quick start and OpenCode's GUI plugin docs.
Does OpenCode support computer use?
Not by itself. This extension adds a computer tool for Windows apps and Android phones, with approval for each app.
How do I edit a custom provider or fetch its models in OpenCode?
Open Settings → Mod → Providers, press Edit on the provider, then Fetch models.
Does it work with OpenCode's free models and my own API keys?
Yes. It runs inside the official app, so your sign-in, OpenCode's free models and your own keys all work as usual.
Does it send my data anywhere?
No. The extension runs locally. Your agent's messages go to the model provider you chose, as they always do in OpenCode. Hooks only come from your global config folder, never from a project, so a cloned repository can't plant commands.
What should I do if something breaks?
Run git pull in the extension folder and restart OpenCode. If the problem stays, open an issue with your OpenCode version, what you did and what you saw.
npm install --legacy-peer-deps
npm run builddist/server.js is the server part and dist/gui-experimental.cjs the desktop part. Set ELECTRON_SKIP_BINARY_DOWNLOAD=1 before npm install to skip Electron's download; only its types are used.
MIT. OpenCode is a trademark of its owners; this is an unofficial community extension.
{ "$schema": "https://opencode.ai/config.json", "plugins": ["C:/Users/<you>/opencode-mod"] }