Back to the Gyuteiverse
Open source · Flagship 01

Clanker Grid

A developer workspace for the terminal-native era.

A single-window desktop workspace for terminal panes, seven AI coding harnesses, Git and VCS, an embedded browser, CodeMirror editing, and persistent project sessions.

Active buildLinux x64 AppImage · v0.12
GitHubReleasesDocumentation
Clanker Grid application showing its file explorer, terminal panes, CodeMirror editor, embedded browser, AI harnesses, and Git panel
Product evidenceReal application
  • Codex
  • Claude Code
  • OpenCode
  • Pi
  • Oh My Pi
  • Hermes
  • Antigravity
Version
0.12.0
License
MIT
Release build
Linux x64 AppImage
Stack
Electron · React · TypeScript
Harnesses
7

Clanker Grid is a desktop app for people who work in the terminal and run several AI coding agents at once. It puts terminals, the agents themselves, Git, a browser and a code editor in one window, and remembers the layout per project.

It does not replace your agents or host a model. Each harness is the real CLI you already have installed, launched into a pane. Clanker adds the surrounding workspace: where it runs, how you resume a conversation, and when an agent needs you.

Supported harnesses

Seven agent CLIs, one integration model

Each harness is a provider in a single registry. Capabilities differ because the CLIs differ, so Clanker only offers what a harness genuinely supports.

Codex

codex

OpenAI's Codex CLI.

  • ResumeJSONL history, local and SSH
  • ForkNative, local and SSH
  • AttentionNative hooks
  • AI commitLocal

Claude Code

claude

Anthropic's Claude Code.

  • ResumeJSONL history, local and SSH
  • ForkNative, local and SSH
  • AttentionSettings hooks
  • AI commitNot implemented

OpenCode

opencode

The open-source terminal agent.

  • ResumeVia its own CLI, local and SSH
  • ForkNative, local and SSH
  • AttentionPlugin
  • AI commitLocal

Pi

pi

Mario Zechner's coding agent.

  • ResumeJSONL history, local and SSH
  • ForkNative, local and SSH
  • AttentionExtension
  • AI commitLocal

Oh My Pi

omp

The OMP coding agent.

  • ResumeJSONL history, local and SSH
  • ForkNative, local and SSH
  • AttentionExtension
  • AI commitLocal

Hermes

hermes --tui

Nous Research's Hermes Agent TUI.

  • ResumeNo history adapter yet
  • ForkNot implemented
  • AttentionSSH observer plugin only
  • AI commitNot implemented

Antigravity

agy

Google's Antigravity CLI.

  • ResumeSQLite history, local and SSH
  • ForkEmulated resume locally; none over SSH
  • AttentionLocal plugin; inert over SSH
  • AI commitLocal
Full capability matrix
HarnessModels (local)History + resumeForkAttentionAI commit
Codexdebug modelsJSONL / JSONLnative / nativenative hooksyes
Claude Code—JSONL / JSONLnative / nativesettings hooks—
OpenCodemodels CLI + fallbacknative CLI / native CLInative / nativepluginyes
Pilist-modelsJSONL / JSONLnative / nativeextensionyes
Oh My PiJSON catalogJSONL / JSONLnative / nativeextensionyes
Hermeslocal TUI gateway——SSH observer plugin—
Antigravitymodels CLI + fallbackSQLite / SQLiteemulated / —plugin / inert over SSHyes

Slash-separated cells read local / SSH. Every harness launches locally and over SSH. The models column is the local catalog; SSH toolbar launches use the host CLI's configured model. AI commit is local-only.

Brand icons from theSVG, each under its own licence (see LICENSES.json). Product names and marks belong to their owners; this project is not affiliated with them. The Oh My Pi mark is from omp.sh.

What's inside

A workspace, not just a terminal multiplexer

Clanker Grid in the Slate theme with Codex, Claude and Pi panes, workspaces and agents listed in the sidebar, and the file explorer below
Slate · three projects, agent panes, and workspaces in the sidebar
Clanker Grid in the Light theme with the TypeScript editor and embedded browser beside dev service controls in the sidebar
Light · editor and browser beside the sidebar
Clanker Grid in the Dark theme with the sidebar collapsed to an icon rail showing each workspace and its agents' harness icons
Dark · sidebar collapsed to an icon rail

Terminal grid

PTY-backed panes (node-pty with xterm.js) in resizable split layouts. A pane that loses its harness falls back to a normal shell, so nothing is lost when an agent exits.

Read the docs

Workspaces and worktrees

Open a local or SSH folder as an empty workspace, then launch your harnesses. New isolated agent puts parallel agents on new branches or existing linked worktrees within one workspace, with checkout branch labels and protected Git worktree management.

Read the docs

Agent attention and usage

Attention badges show which agent is working, asking a question or finished. A status-bar Usage button and optional pinned quota chips show remaining capacity and reset times for Codex, Claude Code, Oh My Pi, Hermes and Antigravity, with optional managed Codex and Claude accounts.

Read the docs

SSH workspaces

Open a remote POSIX directory with a desktop-style folder chooser. Terminals, Git and installed harnesses run on the host, and web services it serves are discovered and previewed in the embedded browser through automatic loopback forwards.

Read the docs

Git and CI

Branches, stashes, merges, diffs and remotes, plus AI-assisted commit messages covering the full working tree, and PR status with CI checks from GitHub, GitLab and Bitbucket.

Read the docs

Browser and annotation

An embedded browser with tabs and DevTools. Select an element, add a note, and send a structured description straight to a local or SSH agent terminal.

Read the docs

Editor and explorer

Explorer follows the focused checkout, while editor tabs keep their own checkout roots. Preview Markdown, including unsaved text, tables, task lists and code blocks; dirty buffers survive checkout removal.

Read the docs

Hermes Assistants

Optionally connect named Hermes profiles to their persistent Bot Chat and an independent embedded Browser, even without an open workspace. Requires the Hermes CLI and a local hermes serve backend; the ordinary Hermes launcher stays unchanged.

Read the docs

Opt-in agent bridge

Give local Claude, Codex, OpenCode and Pi agents authenticated workspace context without editing your MCP configuration. With attention enabled, Claude, Codex and OpenCode can also request isolated checkouts and resume the same conversation there or back in the main checkout.

Read the docs

Checkout dev servers

Run a detected npm, pnpm, yarn or bun dev script from an agent's sidebar row without adding a pane. Each local checkout gets its own server, verified process-group cleanup, explicit Browser preview and failure diagnostics you can copy for an agent.

Read the docs

Your shortcuts

Rebind, unbind and reset any command with conflict detection. Each surface handles only its own keys, so app shortcuts never steal input from a focused terminal or browser page.

Read the docs

Dark, Light and Slate themes are included, and workspaces can live in the sidebar or in tabs. Theming docs · Workspace navigation

Install

Get it running

Download a release, or run it from source.

Linux (AppImage)

Download the AppImage from the latest release, make it executable and run it.

shell
chmod +x 'Clanker Grid-X.Y.Z.AppImage'
./'Clanker Grid-X.Y.Z.AppImage'

Windows builds, when a release includes them, come as an installer and a portable exe. They are unsigned, so choose More info → Run anyway in SmartScreen.

From source

Needs Node.js 22.12+ and npm 10+.

shell
git clone https://github.com/Bynzski/clanker.git
cd clanker
npm install
npm run dev

Open Workspace adds an empty local or SSH workspace; launch installed harnesses from the toolbar afterward. Harness CLIs are not bundled; install the ones you want separately.

Getting started guide · Windows notes

Under the hood

How harnesses plug in

The point of the design is that adding a harness never means editing a central switch.

  • Electron, React 19, TypeScript. Process spawning, SSH and credentials stay in the main process.
  • Provider registry. Each harness is a provider under src/main/harnesses/<id>/ that declares its launch, models, history, fork, attention and usage capabilities. Missing capabilities are simply absent.
  • Transport-neutral execution. Providers describe what to run; the workspace environment decides whether it runs locally or over SSH.
  • Architecture tests. A test scans shared main-process code for harness-specific dispatch, so special cases cannot leak out of providers.
adding a harness
1. add its id and descriptor
2. implement one provider in src/main/harnesses/<id>/
3. implement only the capabilities it genuinely has
4. add provider tests; no central allowlist to edit

Harness integration playbook

Status

Where it stands

Version 0.12, in active development. Known limits, stated plainly:

  • The current release ships as a Linux x64 AppImage only, with no Windows binary. Windows 10 1809+ / 11 remains best-effort supported with compatibility tests in Ubuntu CI; Windows builds, when available, are unsigned (SmartScreen will warn).
  • macOS, ARM64 and WSL are not produced. WSL users can run the Linux AppImage.
  • SSH workspaces connect to remote Linux/POSIX hosts. Remote Windows hosts are unsupported.
  • AI commit and harness accounts are local-only. SSH toolbar launches use the host CLI's model configuration, not saved local model defaults.
  • The ordinary Hermes harness has no session history or fork, and Antigravity has no SSH fork. Optional Hermes Assistants use their own persistent Bot Chat, separate from workspace history.
  • The MCP bridge is off by default and local-only for Claude, Codex, OpenCode and Pi. Pi receives context only; checkout lifecycle tools require a supported provider and agent attention. Codex and OpenCode handoffs wait until the turn ends.
  • Restart reopens validated workspace folders, not terminals, Browser views, editor tabs, pane layouts or Notes visibility. Notes content is retained; recipes can explicitly launch work and apply layouts.
  • Checkout dev servers are local-only and stop with their workspace or app. A dev server alone does not trigger app-close confirmation.
  • Subscription usage readouts exist for Codex, Claude Code, OMP, Hermes and Antigravity; OpenCode and Pi do not have one yet.
Open source

Read it, run it, change it

MIT licensed. Issues, harness requests and pull requests are welcome.

SourceIssuesContributing guideReleasesDocumentation
ElectronReactTypeScriptAI HarnessesGit & CIOpen Source