▄   ▄▄▄▄
   ▀██████▀          █▄
 ▀▀  ██              ██
 ██  ██     ▄███▄ ▄████ ▄█▀█▄
 ██  ██     ██ ██ ██ ██ ██▄█▀
▄██  ▀█████▄▀███▀▄█▀███▄▀█▄▄▄

English | 简体中文

Work in progress. Interfaces, file formats, and defaults still change between releases.

Use a modern terminal. iCode works best in one such as Windows Terminal on Windows or Ghostty on macOS and Linux.

What is iCode?

Let the screenshots speak for themselves.

Home

The agent, model, approval mode and session at a glance, with agents (#), models ($), commands (/), files (@) and the shell (!) a keystroke away from the input bar.

Chat

Answers render as rich Markdown in the terminal, diagrams included.

Workflows

Watch a workflow run node by node, with each agent node's model, tool calls and token spend.

Agents

An agent is configuration, not code: instructions, tools, sub-agents, skills, MCP servers and memory, all edited in one place (F2).

Models

Model profiles from different providers side by side, switchable mid-conversation (F4).

Diff

Every file the agent changed, turn by turn or all at once, in unified or split view.

Rollback

Pick a turn, review the file changes that would be reverted, then discard the conversation after it.

Trajectory

Where the time and tokens went (F12): model versus tools versus waiting, a per-turn breakdown, and token and cache usage.

Every model call, hook and tool call in a turn, laid out on a timeline.

Shell

The shell (!) is a real terminal, so full-screen programs run in place with every keystroke forwarded to them: here htop, inside iCode, inside iCode, inside iCode.

How to run

Use one of the three ways below. iCode ships no model profiles, so press F4 on first launch to add one.

From source

uv is the only prerequisite; it provisions Python 3.14 for you. From a checkout:

uv sync                    # installs iCode and its dev tools into .venv
./scripts/fetch_rg.sh      # downloads the vendored ripgrep; Windows: .\scripts\fetch_rg.ps1
uv run icode               # starts iCode; the package keeps our code name, `chrys`

Install with uv

uv installs iCode from PyPI and provisions Python 3.14 for you:

uv tool install iCode-TUI   # upgrade later with `uv tool upgrade iCode-TUI`
icode

Windows (x64) and Linux (x86-64 or ARM64, glibc 2.27 or later) need nothing else. On a Mac with Apple silicon, run xcode-select --install first.

Offline package

On an Intel Mac, Windows on Arm or an older Linux, use the offline package, which bundles Python and every dependency. The install script downloads the one for your platform, checks it and installs it; run it again to upgrade:

curl -fsSL https://raw.githubusercontent.com/openJiuwen-ai/iCode/main/scripts/install.sh | sh

irm https://raw.githubusercontent.com/openJiuwen-ai/iCode/main/scripts/install.ps1 | iex   # Windows

On a machine without internet access, download the package from Releases elsewhere, unpack it, then install and run iCode:

chmod +x ./icode            # Windows: skip this step
./icode install             # Windows: .\icode.exe install
icode                       # in a new terminal

Getting started lists the package for each platform and its requirements.

User guide

Press F8 inside iCode to open the built-in user guide, a complete walkthrough of using it. The same pages live in docs/, in English and 简体中文.

Privacy

iCode does not collect your data. It has no telemetry, analytics or crash reporting, and it sends nothing about you or your work, usage data included, to us or to any other third party. What iCode itself sends goes only to destinations you configure: the model providers you add, the MCP servers your agents use, and any hooks or OpenTelemetry export you set up. The one exception is the update check: once a day, when it starts, iCode asks PyPI or GitHub for its newest version number so it can tell you about an update. That request carries none of your personal information or data, and you can turn it off with Check for updates in Settings. The web tools are off by default. If you turn them on for an agent, its search queries go to the search provider you configure, or to Exa's public search service (mcp.exa.ai) if you configure none, and the pages it reads are requested directly from their websites. Shell commands, skill scripts and workflows that you or your agents run are programs in their own right, with your network access, so what they send is up to them. Your data is yours alone, and we respect your privacy.

Regulatory compliance

iCode is solely a tool for orchestrating agents and workflows. It does not include or provide any AI model; every model it uses is one you connect to it. When you integrate AI models into iCode for a particular business or engineering use, you bear full responsibility for meeting the compliance obligations that use carries under the EU AI Act (Regulation (EU) 2024/1689) and any other applicable legal or regulatory framework.

License

iCode is open source under the Apache License 2.0. It also contains and bundles third-party software, each part under its own license; NOTICE lists them with their copyright notices and license terms.