Helm（前称路线图板）是一个实时仪表盘和作业跟踪器，用于你用Claude代码构建的项目。命令是roadmap;bin/helm是相同的别名。仓库：github.com/alisinaee/helm。状态文件夹和roadmap包保留它们的旧名称。 它读取每个项目的docs/tasks.json，显示阶段和剩余任务，并列出Claude目前正在运行的作业。 它还会显示你的套餐使用情况和代币限制，以及客服人员遵守的规则。 该页面只在你的Mac上，位于http://127.0.0.1:8780/，机器上除了使用检查和电话隧道外，其他信息都不会离开，而这些隧道是你自己启动的。 你把它当作图形界面使用，AI代理通过roadmap命令使用相同的数据，每个命令取--json。 它是 Python 3.9 或更新版本，只有标准库：没有 pip 安装，没有构建步骤。

安装

你需要Mac、Python 3.9或更新（python3 --version）和Git。

如果还没在你的 PATH 上加 ~/.local/bin（在 上加 export PATH="$HOME/.local/bin:$PATH" ~/.zshrc）。然后用roadmap version和roadmap doctor检查安装情况。roadmap doctor列出了每个检查

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).