Install an Agent First
CorvusTunnel is a remote control layer — it drives an AI coding agent that runs on your machine. Before you start, install at least one supported agent CLI below.
How CorvusTunnel finds your agent
When you run corvustunnel start, it looks for these three commands on your system PATH and lets you launch whichever ones are installed:
claude— Claude Code, by Anthropiccodex— Codex, by OpenAIagy— Antigravity, by Google
You only need one of them to get started. Install the agents you actually use — each has its own account, sign-in, and (for some) usage costs, handled entirely by that agent's own tooling. CorvusTunnel never sees or stores those credentials.
Claude Code · Anthropic
Claude Code
claude requires Node.js 18+Install globally with npm:
$ npm install -g @anthropic-ai/claude-codeVerify
$ claude --versionFirst run opens a browser to sign in to your Anthropic account. Official docs: code.claude.com/docs.
Codex · OpenAI
Codex CLI
codex npm or HomebrewInstall globally with npm:
$ npm install -g @openai/codexmacOS — Homebrew (alternative)
$ brew install --cask codexVerify
$ codex --versionSign in with your OpenAI account or API key on first run. Official docs: developers.openai.com/codex/cli.
Antigravity · Google
Antigravity CLI
agy native installermacOS / Linux
$ curl -fsSL https://antigravity.google/cli/install.sh | bashWindows — PowerShell
> irm https://antigravity.google/cli/install.ps1 | iexVerify
$ agy --versionThe installer drops the binary at ~/.local/bin/agy — open a fresh terminal so it lands on your PATH. Official docs: antigravity.google/docs.
Then start CorvusTunnel
With at least one agent installed and on your PATH, install and launch CorvusTunnel:
$ pip install corvustunnel
$ corvustunnel startScan the QR code with your device and pick the agent you want to drive. If a command isn't found, make sure you opened a new terminal after installing so your shell picks up the updated PATH.
Important — please read
CorvusTunnel is free and open source (MIT). It is provided "as is", without warranty of any kind and without any service-level or support obligation. At this stage every feature is free; optional premium features may be offered in the future, but the core will remain open source.
The agents are separate products. Claude Code, Codex, and Antigravity are developed, owned, and operated by Anthropic, OpenAI, and Google respectively. CorvusTunnel is an independent project by KALAI and is not affiliated with, endorsed by, or sponsored by any of them. All product names, logos, and trademarks belong to their respective owners.
You are responsible for your agent accounts. Each agent has its own terms of service, licensing, sign-in, and any usage or subscription costs. Installing and using them is between you and that vendor — CorvusTunnel neither provides those accounts nor charges for them, and never sees your agent credentials.
The install commands above are provided for convenience and may change over time. Always follow each vendor's official documentation (linked in each section) as the source of truth.