TunnelCode

AI coding agent in your terminal, powered by GPTunnel.

English | Русский

---

TunnelCode is a fork of OpenCode with built-in GPTunnel integration. One install, one API key — and you have a full-featured AI coding agent with access to the best models through GPTunnel.

Installation

npm i -g tunnelcode

Quick Start

1. Get your API key at gptunnel.ru/profile/business
2. Run tunnelcode in your project directory
3. Enter your API key when prompted
4. Choose a model and start working

You can also set the key via environment variable:

export GPTUNNEL_API_KEY=your-key-here
tunnelcode

Features

• Full AI coding agent: file editing, bash commands, code search, MCP support
• Access to all models available through GPTunnel (GPT-4o, Claude, Gemini, and more)
• Terminal UI with two built-in agents:
  • build — full-access agent for development (default)
  • plan — read-only agent for analysis and code exploration
• Subagent @general for complex searches and multistep tasks
• Project-level config via tunnelcode.json (with opencode.json fallback)
• Custom agents and skills via .tunnelcode/ directory
• Client/server architecture — run locally, drive remotely
• LSP support out of the box

Configuration

TunnelCode uses tunnelcode.json for project configuration. If not found, it falls back to opencode.json.

// tunnelcode.json
{
  "provider": {
    "gptunnel": {
      "name": "GPTunnel",
      "api": "https://gptunnel.ru/v1",
      "env": ["GPTUNNEL_API_KEY"]
    }
  },
  "enabled_providers": ["gptunnel"]
}

Custom agents and themes live in .tunnelcode/ (with .opencode/ fallback).

Based on OpenCode

TunnelCode is built on top of OpenCode — the open-source AI coding agent. We maintain a minimal diff from upstream to stay up to date with the latest features and fixes.

Key differences from OpenCode:

• Pre-configured to work with GPTunnel out of the box
• Simplified onboarding — no provider selection, just enter your GPTunnel API key
• Models are loaded dynamically from the GPTunnel API with local caching
• TunnelCode-first config paths (tunnelcode.json, .tunnelcode/)

License

MIT