chartr

AI workspace with a map of your work.

• macOS app (Apple silicon, unsigned)
• Linux AppImage (amd64 or arm64)
• More releases
• Getting started with chartr

An approachable agent multiplexer. Open a space, run agents and commands in tabbed terminal sessions.

Plan with an agent, then chart a map of your work. Drive the map to completion, one ticket at a time. Each ticket spawns a session with the exact context it needs to complete its task.

chartr is still alpha. Features and file formats may change before 1.0.

Key features

• Bring your CLI agents - Register the agents you already use, launch them easily afterwards.
• Use your existing skills - Register your skills from local folders or remote git repositories.
• Live star-map - Visualize your plan and track live progress on an interactive map.
• Ticket-ready sessions - Spawn an agent from a ticket with the relevant context already loaded.
• At-a-glance status - See which sessions are working, idle or waiting for input.
• Self-titling tabs - Agent tabs name themselves from the agent's own session, so a row of tabs reads as your work.
• Folders as spaces - Terminal sessions are grouped into spaces you can filter and reorder.
• Get notified - Receive system notifications when a session needs you.
• Make it yours - Configure terminal appearance, or hack the prompts to suit your workflow.

Installation

Download the macOS or Linux app using the links above. Other builds are available on the releases page.

macOS

The app is currently unsigned. If macOS blocks the first launch:

1. Open chartr and click Done.
2. Go to System Settings → Privacy & Security → Security.
3. Click Open Anyway.

Linux AppImage

Make the AppImage executable, then run it:

chmod +x chartr_linux_amd64.AppImage
./chartr_linux_amd64.AppImage

WebKitGTK comes bundled. An Arch release is also planned.

Debian and Ubuntu

The native package uses your distribution's WebKitGTK and receives its security updates through apt. Ubuntu 24.04+ or Debian 13+ is required.

sudo apt install ./chartr_linux_amd64.deb

Fedora

The Fedora package likewise uses the distribution's WebKitGTK runtime.

sudo dnf install ./chartr_linux_amd64.rpm

Windows

The fully-supported Windows desktop app will be coming soon.

CLI usage and building from source

See CLI and source builds.

Documentation

• Getting started — fresh machine to first star-map
• CLI and source builds — run the server or build chartr locally
• ADRs — why it is shaped the way it is
• Security — found a vulnerability? here's how to report it.

Project status

The current release is v0.2.4. Download it from the releases page.

Highlights in v0.2.4:

• Self-titling tabs - Tabs use harness titles or generate one from the first completed turn. Titles are searchable; configure them in Settings.
• Accurate notifications - Completion is read from agent transcripts for claude, codex, grok, kimi and pi.
• Faster terminal - Select the renderer in terminal.toml; Linux defaults to canvas, with DOM fallback and latency tracking.
• Find in the terminal - Ctrl+Shift+F opens search in the active session.
• Sortable sessions - Drag session rows to reorder them within a space.
• Persistent free shells - Ctrl+C or /exit leaves the shell and scrollback open.
• Linux desktop fixes - Improved AppImage paths, environment handling, resource cleanup, icons and folder chooser errors.
• Better agent status - Fixed Claude's spinner and pre-trusted kimi workspaces.
• Sharper chrome - Standardized icon sizing and native title-bar layout.

Still to come:

• Windows desktop app - Package and test the existing WebView2 shell.
• AUR release - Distribute chartr through the Arch User Repository.
• Prompt presets - A catalog of reusable prompts a space launches with.
• GitHub Issues integration - Bring GitHub issues into the chartr workflow.
• Inbox mode - Add an alternate view for tasks that need your attention.
• Built-in updater - Detect new releases and provide a way to install them.
• Scratch location - Make its starting directory configurable.
• Alternate keybindings - Add Neovim and Emacs keybinding presets.
• More panes - Add browser, source control, code review, and token usage panes alongside maps.
• Agent onboarding - Detect installed agent CLIs on first launch and guide users through registration.
• Agent status coverage - Expand live detection for third-party agents and uncommon prompts.

Known bugs:

• Ticket details - Markdown does not render cleanly, and clicking a ticket reference does not open that ticket.
• Folder picker - The chooser is raised by the server, so it needs zenity or kdialog on Linux and is unavailable on Windows. Where none is found, register a space by typing its absolute path instead.
• Notification coverage - Completion is only as good as the transcript behind it. An agent chartr cannot read a transcript for still falls back to screen-derived timing, which can fire late or not at all.
• Claude status - Claude reads as blocked on its permission prompt, but still reports idle while it waits on its other selectors.

See the GitHub releases for published release notes and open issues for additional reports.

No hosted service or user accounts will ever be planned. chartr does not send any usage data or telemetry.

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

Acknowledgements

• @brownoxford for privately reporting localhost trust-boundary vulnerabilities that allowed cross-origin WebSocket control of live terminals, DNS-rebinding access, and CORS-simple API writes. His report led to strict Origin, Host, and content-type validation, owner-only state, verified build tooling, and safer bind warnings.
• @bradymwilliams for reporting an issue that led to improvements when opening chartr from monorepo subdirectories.