OneCode

A desktop workspace that connects Gemini or ChatGPT to tools on your Windows PC. Work with files, run commands, use your MCP plugins and local skills, and keep your chats and projects together.

Download OneCode for Windows · Setup guide

Install

1. Download OneCode-Setup-x64.exe from Releases and run it.
2. Install Tailscale on your PC and sign in with your own account.
3. Open OneCode → Settings → Setup. Follow the connection checks and wait for Public HTTPS to pass before copying this PC’s connector URL. A new Tailscale address can take up to ten minutes to appear in public DNS.
4. Load the bundled OneCode Companion extension in Brave, Chrome or Edge. Setup opens its folder for you.
5. Choose Gemini or ChatGPT in Setup. Add OneCode Core in that provider using the exact URL shown, then approve a working folder and choose the tools you want to enable.
6. Gemini users can optionally install the bundled gemini-code skill: save its ZIP, open Gemini → Customize → Skills, upload it and choose Create. SKILL.md is included in the installer and source; the ZIP is also on Releases.

Send tasks from OneCode. Your selected provider account supplies the model; no model API key is required for ordinary browser chats. Each person runs OneCode and Tailscale on their own PC. There is no OneCode cloud service to subscribe to or share.

The skill provides reusable instructions. The Core connector provides access to local tools and works without the skill: OneCode selects it and supplies its tool instructions when sending a task. Installing the skill cannot repair an unreachable server URL. Use the same Google account for the connector, skill and Companion.

A connection that survives restarts

Tailscale Funnel gives your PC a stable HTTPS address. Once connected, ordinary restarts keep the same connector URL. Keep the same Tailscale device and tailnet, and keep the MCP paths stored in OneCode. The PC, OneCode and Tailscale must be running for tools to work.

Cloudflare quick tunnels remain available as an alternative. Their address changes when the tunnel restarts, so switching to one requires updating the URL in the selected provider.

Updates and longer tasks

OneCode downloads updates from this repository in the background. When an update is ready, choose Update and restart when convenient. If work is still running, OneCode waits; you can cancel the pending restart. Ordinary Quit leaves a downloaded update for later. Windows uses smaller differential downloads when a previous installer is cached, with a full download as the fallback. Versions 0.2.6 and earlier need one final manual installer download to enable this updater.

Use Compact & Resume to continue a long task in a fresh chat. OneCode uses the active provider’s receipt flow, saves and verifies the Markdown handoff, then passes it to a new chat on the same provider. Keep the browser and connection running. The context counter is an estimate for OneCode’s compaction settings, not the provider’s actual remaining quota.

Provider authors should use the multi-provider compatibility audit before enabling another browser AI service.

Before you start

• This release supports Gemini web and ChatGPT web on Windows x64 through one Companion extension.
• The selected provider decides which models and custom MCP apps your account can use. OneCode cannot grant subscription features or extra usage.
• Fresh installs enable file reading only. Enable commands, writes or desktop control deliberately; those tools act with your Windows user’s privileges.
• Enabled tool confirmations on OneCode’s own Gemini connector can be handled automatically by its companion. Other apps’ approvals are not included.
• The installer is currently unsigned. Windows may show a publisher warning; compare its SHA-256 checksum with the release before running it.
• Keep connector URLs private. They contain access credentials. See Security.

OneCode is open source under the MIT license, adapted from Chat On Steroids at commit d55f7a45331f0c84671d3b32c44588a40ca9457f. Original copyright notices and third-party licenses are retained.