Helm

Helm (formerly roadmap-board) is a live dashboard and job tracker for projects that you build with Claude Code. The command is roadmap; bin/helm is an identical alias. Repo: github.com/alisinaee/helm. State folders and the roadmap package keep their old names. It reads each project’s docs/tasks.json, shows the phases and the tasks left, and lists the jobs Claude is running now. It also shows your plan usage and your token limits, with rules that agents follow. The page is served on your Mac only, at http://127.0.0.1:8780/, and nothing leaves the machine except the usage check and the phone tunnel, which you start yourself. You use it as a GUI, and AI agents use the same data through the roadmap command, where every command takes --json. It is Python 3.9 or newer with the standard library only: nothing to pip install, no build step.

Install

You need a Mac, Python 3.9 or newer (python3 --version), and Git.

git clone  ~/Works/helm
cd ~/Works/helm
make check                               # lint and unit tests; it must pass before you use it
bin/roadmap service install              # the background agent that serves the page on 127.0.0.1:8780
mkdir -p ~/.local/bin
ln -s "$PWD/bin/roadmap" ~/.local/bin/roadmap

Put ~/.local/bin on your PATH if it is not there yet (add export PATH="$HOME/.local/bin:$PATH" to ~/.zshrc). Then check the install with roadmap version and roadmap doctor. roadmap doctor lists each check as ok, warn or fail, with the fix for each problem, and it is safe to run at any time. Keep the clone where it is: the launchd agent and the hooks in your projects point at this folder.

Quick start

Run roadmap init in your project folder (registers it, installs the hooks, starts the service; safe to repeat), then start Claude Code and run /head. --no-service skips the service.

First run

1. Register your project. A project is any folder with a docs/ folder inside it: roadmap project init and roadmap project add --name "My App".
2. Install the hooks, so Claude Code records jobs for you: roadmap hooks install my-app.
3. Open the dashboard: roadmap open, or go to http://127.0.0.1:8780/ yourself.

The details, and a job recorded by hand, are in Quick start with a project.

The dashboard

The GUI has these sections, in the navigation rail: Overview, Inbox, Roadmap, Work, Issues, Agents, Tokens, Rules, Research, Activity and Settings.

Honest notes

• Usage. The usage collector reads the Claude Code sign-in from the keychain, which needs a Claude Code CLI login on this Mac for the account token. macOS asks once, and you should choose Always Allow. Without that login, enter the numbers yourself with roadmap usage push (see Plan usage).