chartr

Agent multiplexer with a map of the work.

Download macOS app (Apple silicon, unsigned)

Download Linux AppImage (amd64 or arm64)

More platforms

Chart a wayfinder map inside chartr, then drive it to completion. The plan renders as a star-map; take a ticket off the frontier, pick an agent, and the session opens with the map, the ticket, and its blockers' answers already in the buffer.

Without a map it is a plain multiplexer: projects in a sidebar, shells and agent CLIs in tabs.

Key features

• Chart the map without leaving. Launch a planning agent from the sidebar and whatever it writes to .plan/maps/ draws as a star-map the moment it hits disk.
• Spawn off the frontier. Take an unblocked ticket, pick a role and an agent, and the session opens in that agent's own TUI with full context already submitted.
• Whatever CLI you run. The adapter models one thing, how a binary takes its opening line, so anything on PATH registers and claude, codex, opencode, kimi, grok and pi are detected for you.
• Tells blocked from thinking. Tab status comes from what an agent broadcasts and draws, so the sidebar flags whichever space is waiting on you.
• The map on disk is the state. A ticket resolves when its ## Answer appears, and chartr's only writes are the claim and release commits on the ticket file.
• Skills are files. Plain SKILL.md directories you can shadow per repo or per machine, and your own launchable skill shows up in the sidebar.
• Terminal in one TOML. Presets, 21 colour slots, font, cursor, padding, keybindings.

Installation

Grab your platform's archive from the releases page and run it:

chartr                 # http://127.0.0.1:8787
chartr -addr :9000
chartr -data-dir ~/w   # session root (default: cwd)

Install your own agent CLIs; chartr ships none.

Linux desktop app

Download chartr_linux_amd64.AppImage (or arm64), make it executable, run it:

chmod +x chartr_linux_amd64.AppImage
./chartr_linux_amd64.AppImage

No install, no dependencies — WebKitGTK is bundled. It borrows only what has to come from your machine: the GPU driver, your font configuration and your compositor.

Also available as make appimage from source, on Linux.

macOS first launch

The .dmg is unsigned, so macOS blocks it once:

1. Open chartr, click Done (not Move to Trash).
2. System Settings → Privacy & Security → Security → Open Anyway.

Or xattr -d com.apple.quarantine /Applications/chartr.app.

From source

Go 1.26+, Node 22+.

make build     # → bin/chartr
make check
make test
make dmg       # the macOS app

Documentation

• Getting started — fresh machine to first star-map
• Design system — tokens, primitives, the chrome/island split
• ADRs — why it is shaped the way it is

Project status

v0.2.1 is out — grab a binary from the releases page. chartr is used to build chartr, but it is still alpha: the shape moves and breaking changes are expected before 1.0.

Shipped in v0.2.1:

• Spaces, tabs, activity detection
• Maps: star-map, spawn, claim/release
• Release pipeline — checksummed binaries, macOS .dmg, Linux .AppImage
• Getting started, written against a fresh machine
• Linux desktop app — an .AppImage with WebKitGTK bundled, gated on a render check against a host with no WebKit installed.

Not yet:

• Shift+Enter as a literal newline — the resolve seam and its tests are in, but the keystroke doesn't land in a real terminal. Broken, not missing.
• Drag to reorder the sidebar — spaces stay where you put them, and pinned goes away with the recency sort it fought over. Spec.
• "It's done" notifications — a session that worked longer than a configurable n seconds tells you when it stops, whether it landed, blocked or died, with the cockpit closed. Spec.

Not planned: a hosted service, an account, anything that phones home.

Platform support

One supported artifact: the cgo-free binary that serves the cockpit in your browser, green on all three OSes before a tag ships. The Linux .AppImage is built and smoke-tested as a release gate, so it ships whenever the supported binary does. The macOS .dmg is a best-effort extra: it needs cgo and system webview libs, and may simply be absent (ADR 0011).

Platform	Binary	Desktop app
macOS arm64	✅	.dmg, unsigned
macOS amd64	✅	none (cgo won't cross-compile)
Linux amd64 / arm64	✅	.AppImage, WebKitGTK bundled
Windows amd64 / arm64	✅	none

The Linux .AppImage carries its own WebKitGTK, so it does not care whether your distro ships webkit2gtk-4.1, the older 4.0, or neither. Every tag builds it and runs it against a container with no WebKit and no GTK installed, screenshotting the window to prove the cockpit rendered rather than trusting an exit code — and that check gates the release (ADR 0011).

Windows has no packaged app and none is scheduled; it can be built locally with make webview (ADR 0013).

Windows is built and its ConPTY layer is smoke-tested every change, but it isn't driven daily, so WSL2 is the sure path.

Related projects

• herdr — the agent multiplexer that inspired this, in your terminal instead of a window
• wayfinder-maps — my read-only map CLI and viewer; where the star-map started
• mattpocock/skills — the original /wayfinder skill and the method the maps side drives

Demonstration

demo.mp4