Hamloy for Claude Code
Run two or three Claude Code sessions on one repo and see all of them in one place: who is on what, what they finished, what they ruled out, and what they need from you.
Claude Code is good at one task in one session. The trouble starts with the second session. Each window knows only its own work, so to find out what happened you scroll back through every terminal. A session you closed last night took what it was doing with it. The decision it needed from you scrolled past in a terminal you weren't watching.
Hamloy gives every session one list, and you one board to see it on. Each session writes what it's on, what it finished and merged, and what it ruled out. Decisions go on your Questions list with the options and the one Claude recommends. What only you can do, a key, an account, a deploy, goes on Requests with the exact steps. A session claims a task before it starts, so two never take the same one.
What it looks like in Claude Code
Hamloy is one more MCP server, so its calls look like any other tool:
> Do the streak counter next.
⏺ hamloy - Claim an item (MCP)(key: "B-k3f9")
⎿ B-k3f9@2 "Streak counter on the home screen" claimed by this session
⏺ Writing the streak count for each habit now.
When the work is committed and done:
⏺ hamloy - Mark an item done (MCP)(key: "B-k3f9@2")
⎿ [x] B-k3f9@3 Streak counter on the home screen (done by claude on 2026-10-09; on feat/streaks, not merged into main yet)
The tick knows the branch. The task stays "on feat/streaks" until that commit reaches main, and the board says so. More in git.
Here now
claude (streaks)
on main in pebble
“work on the streak counter”
On Streak counter on the home screen
8a3c1f02 Claude Code · active just now
codex
on feat/haptics in pebble
On Haptic tap when a habit is checked off
3f9a21c0 Codex · active 2m ago
claude (api)
on main in pebble-api
On Sync endpoint for habits
c71e5d94 Claude Code · active 6m ago
Recent changes
-
codex merged the work of Dark mode for the habit list
4m ago -
claude added a note to Streak counter on the home screen: counting by calendar week ruled out: a missed Sunday reset every streak
12m ago -
claude added Where should synced habits live?
25m ago -
claude added Create the Apple Developer account
31m ago -
codex finished Dark mode for the habit list
48m ago -
claude finished Habit list loads from the local cache
1h ago
What the program adds
One paste in the folder you work in installs hamloy, signs you in once in the
browser, and sets up Claude Code (and Codex, if you have it) for that folder.
It adds hooks: they tell Hamloy which repo, branch and files Claude touches, and
bring the lists' news into the session. That gives you:
-
A session starts knowing the lists. Before your first prompt, Claude hears what's open and the task to take next:
Hamloy · Pebble · pebble on main backlog ## Habits [ ] B-k3f9@2 Streak counter on the home screen [ ] B-vaxb@1 Haptic tap when a habit is checked off Next up, the most important task ready and free: B-k3f9@2 Streak counter on the home screen. Claim it before you start (the claim tool). -
A closed session lets go at once. Its claims go back to ready, and the next session can take them.
-
A restart takes its own claim back, without force, along with the messages sent to the session it replaces. See claims.
-
Subagents count. A subagent starts with the lists too, as a session of its own.
-
Files and branches. Claude is told when it edits a file another session changed, and on which branch, before the two collide at merge time.
-
/hamloydraws the lists in the chat, without asking the model. -
hamloy panelkeeps the lists beside Claude Code: a split in tmux, Zellij, iTerm2, WezTerm, Kitty and Windows Terminal, a window beside it in other terminals.
The status line
Run hamloy statusline on and Claude Code's status line shows the task this
session is on and what waits for you. It's opt-in, --below keeps your own
status line above it, and hamloy statusline off puts yours back as it was.
> Do the streak counter next.
⏺ hamloy - Claim an item (MCP)(key: "B-k3f9")
⎿ B-k3f9@2 claimed by this session
⏺ Writing the streak count for each habit now.
Hamloy ◐ B-k3f9 Streak counter on the… 2 for you · 5 ready
How should a shared streak look?
claude · 2d agoWhich sign-in should Pebble have at launch?
claude · 5d agoQuestions from a session you aren't watching
When Claude needs a decision, it adds a question with options and the one it recommends, then goes on with the work every option needs. You answer on the board, from any machine or your phone, and the session hears it with its next tool reply. More in questions.
Answering this lets Offline sync with a local SQLite cache go ahead.
• I asked you where synced habits should live (Q-sy2c). Until you answer, I'm writing the local SQLite cache, which every option needs.
Claude Code next to other tools
Codex on the same repo, Cursor in the editor, Claude on your phone: they all see the same lists and the same claims. Agents tell each other things by task key with the message tool, and it reaches the session on that task under its next tool reply. See messages and Hamloy for Codex.
Connect in a minute
In the folder you work in:
curl -fsSL https://hamloy.com/install | sh
On Windows, in PowerShell: irm https://hamloy.com/install.ps1 | iex. Then
start Claude Code there, or restart it, and type /hamloy. hamloy disconnect
undoes it.
Claude Code is set up per folder: the program gives each folder you link its
project's own address, and the hooks stay quiet in folders that aren't linked.
Prefer no program? claude mcp add --transport http hamloy with your project's
address works too, or a .mcp.json committed to the repo so every clone and
worktree reaches the same lists, each person signed in as themselves. The full steps, with tokens for machines nobody
signs in on, are in Claude Code setup.
Questions
Does Claude Code need the program, or is the link enough?
The link alone gives Claude Code the tools, and it works. The program adds the hooks, which tell each session the lists when it starts, follow the work through git, warn about files another session changed, and let go of a closed session's claims at once. It also brings /hamloy, the panel and the status line.
Does it see my code?
No. Hamloy keeps what agents write to your lists, and where they work, the folder, the repo, the branch and the names of the files they edit, never the files themselves.
Does it replace Claude Code's own to-do list?
No. Claude Code's to-dos are its plan for the turn it's in. Hamloy is the project's list, kept across sessions, tools and people.