Hgnucomb

hgnucomb

A spatial terminal multiplexer. Your terminals live on a hex grid -- navigate between them like an RTS, build spatial memory of your workspace, and optionally let AI agents coordinate across it.

Vibe amongst the hivemind.


Why

Terminal multiplexers give you tabs and panes. That's a 1D mental model for an multi-dimensional workflow.

hgnucomb puts your terminals on a 2D hex grid. Navigate with vim keys. Build a layout that mirrors how you think about your project. "The API server is up and to the left, the tests are to the right." That spatial memory persists across context switches in a way that "tab 4" never will. Also, it's fun.

AI agents live on the same grid -- spawn them, watch them work, merge their code safely through a staging workflow with human approval.

Quick Start

npm install -g hgnucomb
hgnucomb

Installs the CLI globally, then starts the server and opens the browser. Run `hgnucomb` from any project directory -- it operates in your current working directory.

Prerequisites

• Node.js 20+
• C++ build tools (node-pty compiles a native addon at install time) -- xcode-select --install on macOS
• Claude Code CLI (claude) -- only needed for AI agents

Development

git clone git@github.com:kylesnowschwartz/hgnucomb.git
cd hgnucomb
just install    # pnpm install
just dev        # frontend :5173 + server :3001

The Grid

Navigate with `hjkl` or arrow keys. Press `t` on any empty cell to spawn a terminal. Press `Enter` to open it. Press `Cmd+Escape` to close the panel and return to the grid. Your terminal keeps running in the background -- reopen it anytime.

That's it. Spatial terminals. When the terminal panel is open, prepend navigation with `cmd + ` to navigate the canvas.

The Terminal

Each cell on the grid is a real terminal -- [xterm.js]