treacle

A workspace for Claude Code, Codex and the other coding agents, on the Mac or Linux box you leave on.

Six agents running.One window shows them all.The terminal is still yours.

Six agents running.One screen shows them all.The terminal stays yours.

Treacle is a visual layer over the coding-agent sessions on your Mac or Linux box. Every worktree and every session on one screen, a lamp that says who is working and who is waiting, and the questions as cards you answer in place. tmux and git worktrees underneath, so nothing is hidden from you. A Chrome app at the desk, the same app on your phone, so nothing is tied to a device.

Treacle is a visual layer over the coding-agent sessions on your Mac or Linux box. Every worktree and every session on one screen, a lamp that says who is working and who is waiting, and the questions as cards you answer with a tap. tmux and git worktrees underneath, so nothing is hidden from you. The same app you use at the desk, on the phone in your pocket.

$ curl -fsSL https://treacle.dev/install | sh

macOS on Apple silicon, or Linux on x64 or arm64. Needs tmux and an agent you already run. Self-hosted, one signed binary, no account; the installer checks its checksum and signature before it lands. Then treacle setup on the machine that stays on.

Prefer a Mac window to a Chrome tab? Treacle for Mac is the same app in its own window, signed and notarized. Install it on any Mac and pair it from Host → add a device.

Treacle⋮
9:41▰▰▰

treacle

7 worktreesboard+ folder🔊🔔
needs you1
harbour : hbr-212-rate-limit-invites Rate-limit invite links ↳ claude · harbour 3m ago
✕
Commit and open the PR?
HBR-212 is done. Type-check, lint and 1,212 unit tests are green. Nothing is committed yet.
Yes, open itAmend the last commitother…
›harbour 21 3 worktrees
hbr-212-rate-limit-invites3m agofocusedHBR-212PR #114
Adding a per-inviter token bucket, then a 429 with a retry hint.
Rate-limit invite links3m✕
+ tab🗑 delete
hbr-219-webhook-backoff12m agoHBR-219
Retrying the webhook relay with backoff instead of dropping the event.
claude · harbour12m✕
zsh · harbour1h✕
main2h agocheckoutPR #109 merged
codex · harbour2h✕
›treacle 1 2 worktrees
›tidepool1 worktree
2 quiet folders ›

Terminals don't scale past three agents.

See everything. One worktree per ticket, one agent per worktree, and you are cycling through six tmux windows to find the one that stopped. Treacle puts them on one screen: a lamp per session, a subject line per worktree, the ticket and the PR, how much context and quota is left. The sessions waiting on you go to the top, with the question and its options as buttons.

Keep control. Every card has a box for answering in your own words. The mode chip cycles plan and auto. Send becomes stop while the agent works. Deleting a worktree with uncommitted changes makes you type CLOSE. And the raw tmux pane is one clicktap away, because it is the same pane: quit treacle and your shells are exactly where you left them.

Any device. Install it as a Chrome app and it lives in the Dock with a badge that counts the inbox. Open the same address on your phone and it is the same app, with push notifications for when you are away from the desk. Served from your own Mac; the phone pairs with it and talks over a sealed link, so nothing in between can read it.

Any device. Add it to the home screen and the icon counts the inbox; a push finds you when a session needs you. Back at the desk it is a Chrome app in the Dock, the same app at the same address. Served from your own Mac; the phone pairs with it and talks over a sealed link, so nothing in between can read it.

What is in it.

Everything the terminal says, said better.

The same session, twice. On the left, what tmux shows. On the right, what treacle shows: tool calls as one-line rows, edits as real diffs, the agent's reply as rendered markdown, and the question as a card you can answer. Both are live. Type in either and the other follows.

the tmux panethe same session in treacle
Treacle⋮
9:41▰▰▰
‹
harbour : hbr-212-rate-limit-invitesRate-limit invite links
workingAUTOterm
+/Tell the agent…●Send

Decisions in place, not in scrollback.

Questions become cards. Permission prompts too.

Claude Code's hooks tell treacle the instant a session is waiting on you, so the lamp flips to needs-you before you would have noticed in the terminal. The question lands in the inbox with its options as buttons, and as a push notification with the same buttons if the app is closed.

Start a session with TREACLE_REMOTE_PERMISSIONS=1 and gated shell commands arrive as an Allow or Deny card with the full command shown. Ignore it and the terminal prompt takes over after two minutes, as it always did. Nothing is ever auto-approved.

An agent can also ask on purpose. Over MCP it can put up a choice, or a whole proposal with Approve and Reject, and block until you answer. Dismiss the card and it is told it was dismissed, not answered.

Treacle⋮
9:41▰▰▰
‹
treacle : fold-quiet-foldersFold quiet folders behind one row
needs youPLANterm
decision
Allow Bash?
bun test packages/web
Allow
run it, this once
Deny
block this call — the agent is told no
decision
Approve the migration plan?

Split the folders table. Move quiet-folder state into its own table so a collapse never rewrites a repo row.

Two migrations, both reversible. No data moves.

Approve
go ahead as proposed
Reject
do not do this
Or answer in your own words…Send
+/Tell the agent…●Send

The header knows the state of the work.

Name a branch the Linear way and the session links its ticket, with the ticket's title and status once you add an API key. The PR comes from gh and shows its checks and review state. A plan the agent publishes pins under the header and ticks off in place as it works.

The strip at the bottom is the part you usually have to squint at: the model, the account, how many files changed and by how much, how full the context is, and how much of the five-hour and seven-day usage windows is gone. It turns amber past 80%.

AUTO / PLAN
clicktap the chip to cycle the agent's mode, the same as Shift+Tab
■ stop
Send becomes stop while the agent is working; it sends Escape
term
the real pane, cursor-true, with a key bar for esc, tab, ^C and the arrows
Treacle⋮
9:41▰▰▰
‹
harbour : hbr-212-rate-limit-invitesRate-limit invite links
workingAUTOterm
plan3/4Cover the burst case in tests›
✓Add a token bucket per inviter
✓Return 429 with a retry hint
▸Cover the burst case in tests
·Note the limit in the API docs
⏺Edit invites.ts +6 −1
⏺$ bun test src/invites
claude
The bucket refills at ten a minute per inviter, and a burst past it returns 429 with a retry-after. Both read the same clock, so they can't disagree.
working…
opus-5you@example.comΔ 4 files +42 −7ctx 118k/200k5h 41%7d 83%
+/Tell the agent…●■ stop

The real terminal is one clicktap away.

Cursor-true tmux mirroring over control mode, in the same window. Select, Paste and Copy for the things a browser is bad at, and a key bar for esc, tab, the control keys and the arrows for when there is no keyboard. Interactive commands open here on their own. It is the same pane you would attach to from a shell, so nothing treacle shows you is a summary of something you can't see.

Cursor-true tmux mirroring over control mode. A key bar for esc, tab, the control keys and the arrows, because a phone keyboard has none of them. Select, Paste and Copy for the rest. Interactive commands open here on their own. On an iPad with a keyboard it is a place you can work from, not just check on.

Treacle⋮
9:41▰▰▰
‹‹Rate-limit invite links+SelectPasteDone
● Now the full suite, to catch anything the bucket change disturbed: Ran 3 shell commands ● Duplicate import from the same barrel, folding it in: Ran 2 shell commands ● HBR-212 is done. Both acceptance criteria are met, and the gate is green: type-check, lint, and 1,212 unit tests across 96 files. What changed 1. A token bucket per inviter — src/invites/bucket.ts:12 Ten a minute, refilled on read. The bucket key is the inviter id, so a burst from one account cannot starve another. 2. 429 with a retry hint — src/invites/route.ts:41 A burst past the limit returns 429 and a retry-after header computed from the same clock the bucket reads. Tests - bucket.test.ts covers refill, the burst boundary either side, and two inviters sharing a second. - route.test.ts pins the header value against a frozen clock. One thing to flag - Password resets are still unlimited. Same shape, same fix. Worth a follow-up ticket if you agree. ● Baked for 6m 02s · done 9:41 AM ❯ hbr-212 git:(hbr-212-rate-limit-invites) [Opus 5] ctx:41% ▶▶ auto mode on (shift+tab to cycle) · PR #114 · ← 2 agents
^esctab^C^D^Z^R↑↓←→⏎

The status line at the bottom is Claude Code's own. The key bar underneath is treacle's, and matters most on a tablet.

A board for work that outlives a session.

A session is a conversation. A task is a thing that has to be finished. The board holds the second kind, and it will not take a wish: every task needs a definition of done and, ideally, a command that proves it. Flip between sessions and board with one button in the header.

Start cuts the worktree and briefs the agent.

ClickTap start on a ready task and treacle creates a worktree from the base ref, writes the brief to .treacle/task.md, launches the agent you chose and sends the opening message. Watch it in the session feed or go and do something else.

The agent reports back over MCP: a note, a link, or done. Done runs the task's check command in the worktree and moves the task to review, where it waits for you with the evidence and a diff against base. Accept, or send it back with a reason.

Tasks can wait on other tasks, be blocked with a reason, and be given grants: things the agent may see. The board runs left to right: proposed, next up, in progress, needs you, blocked, done today. On a phone it is one list, most urgent first, and a card opens its session while the pane is still there.

Treacle⋮
9:41▰▰▰

treacle

connectedsessions+ folder🔊🔔
now
⬤
harbour: Rate-limit invite linkswants review
3m ago
▮
harbour: Retry the webhook relayworking
12m ago
next up · 2 ready
○
treacle: Fold quiet folders behind one rowafter Inbox counts the worktree
○
tidepool: Rebuild the photo index nightly
+
task
proposed · 1
○
treacle: Usage figures say how old they aredraft
1 blocked›
3 done today›

A task you can read.

Open a task and you get what it is for, what would count as finished, the check that proves it, and every attempt with what it produced. The changes tray shows the files against base with a diff you can unfold.

Drafting one takes a title, a done-when, an intent, a check command, an agent and a base ref. The hint under done-when says it plainly: the board is not for wishes.

Treacle⋮
9:41▰▰▰
Rate-limit invite links review
projectharbour
intentOne account must not be able to mint invite links without limit. Leave the invite schema alone.
done whenInvites are capped per inviter, a burst returns 429 with a retry hint, and tests cover both.
checkbun test
runs asClaude · from main · harbour
afternothing — can start any time
attempt · donehbr-212-rate-limit-invites · Claude
check ✓   note · 1,212 tests, 96 files
link · PR #114
changes4 files against main
invites.ts +18 −2
bucket.ts +9 −3
send back…accept

Worktrees and tabs, without touching a shell.

New branch, new worktree, pick the agent.

Every registered repo lists its worktrees as cards with a colour, the branch, the ticket and PR pills, and a one-line subject a small model writes about what is going on in there. Tabs are tmux sessions, busiest first, each with a lamp. Merged work shows purple at a glance.

Add a worktree with a branch name and a base. Add a tab with Terminal, Claude or Codex, and pick the account if you have more than one. Codex sessions get a feed and question cards of their own.

Deleting refuses while anything is running or uncommitted in there, says which, and makes you type CLOSE to override it. Folders with nothing going on for a day fold away behind one row.

Treacle⋮
9:41▰▰▰
new worktree in harbour
branchhbr-231-audit-loga Linear-style name links its ticket
frommainthe branch to cut it from — blank uses the checkout's HEAD
CancelNext
new worktree hbr-231-audit-log
Terminal›
Claude2 accounts›
Codex›
Cancel

Inside a session, more than a transcript.

The feed is where most of the day goes, so most of the small things live there. None of them hides the pane: each one is a shortcut for something you could also do in the terminal.

Fork from any message

Every message has a fork button. The conversation up to that point becomes a new tab, here or in a new worktree cut from main. The original transcript is only read.

Review comments on the diff

The changes sheet opens a hunk's whole file with the added lines marked. ClickTap a line to comment; the comments go back to the session as one message, each naming its file and line.

Apply back to main

"→ main" on a branch worktree lists the commits main does not have, lets you pick, and cherry-picks them onto a clean main. A conflict leaves main as it was. Nothing is pushed.

Launch presets

A preset is an agent, an account, a model, an effort and a permission mode under one name. It sits at the top of every launch sheet. The server expands the name, so nothing typed on a phone reaches the shell.

Accounts as a pool

Add a second Claude or Codex login from the app. For Claude accounts, the sidebar shows each one's live 5-hour and 7-day headroom, the picker starts on the roomiest, and when one hits its limit a card offers the others and resumes the conversation there.

Sessions that sleep

An agent idle for two hours, with nothing uncommitted and nothing running, quits to free memory. The tab and the conversation stay, and opening it or sending it a message resumes it. The three most recent stay warm.

Background agents, in view

Sub-agents a session launches get a strip of their own: what each is doing now, its calls and tokens, and its transcript as a feed. The session says working until the last one finishes. A Workflow run gets its phases as a stepper.

Documents, images, previews

Plans and docs an agent writes or shows open in a reader you can copy from or save. Images, HTML reviews, audio and video it points at render in place. Dev-server previews show inline and go full screen when asked.

One-tap answers

A command Claude suggests runs with one tap. A finished turn that hands a decision back offers its options as replies. A queued message can be sent now without cancelling what is running.

Keys stay out of the chat

Paste an API key into a message and the treacle mod stores it in the Keychain and passes Claude a placeholder. Claude uses it through a tool that hands the value over on stdin, and tool output is scrubbed of it.

Voice in, files in

Hold the mic and speak. whisper.cpp on your Mac transcribes it, or add a Deepgram key and words stream in as you say them. + uploads photos, files and video up to 2GB to the host.

A terminal beside it

"+ term" opens a shell in the session's worktree, split beside the feed or under it. Every pane boundary drags. The worktree's other tabs switch in place.

"+ term" opens a shell in the session's worktree, one tap from the feed. The raw pane of the agent itself is behind "term" in the header.

A desk that watches the board, and asks first.

The desk is one Claude Code session treacle keeps for itself, outside every worktree. It reads the board and the live sessions, tells you what matters, and drafts tasks for work that is missing. It starts nothing, types into nothing and closes nothing without a card you answer. Asking it in plain words counts as answering.

Digests that say only what changed.

On a clock you set, the desk reads the board and writes a digest. It leads with the one thing to do next, adds at most three more, and sends nothing when nothing has moved. Snooze an item until Monday, or mark it known until it changes.

Loose ends arrive on one tidy card with a tick per item: a review task whose PR merged, a run that has gone quiet for days, a merged worktree nobody removed, an old draft. Each is checked against the board again before it runs.

It names sessions, tasks, PRs and Linear tickets as links you can open. On a desktop its chat sits on the right of the desk view, beside an overview, the board or the host, whichever you switch to.On a phone the desk tab switches between its chat, an overview, the board and the host.

Treacle⋮
9:41▰▰▰

desk

digest · 08:30
Next: accept harbour: Rate-limit invite links. Check passed, PR #114 is green.
Also: tidepool: Rebuild the photo index has been blocked on a missing bucket name since Tuesday.
tidy up2
Close these loose ends?
☑ hbr-209-csv-export: PR #108 merged, worktree clean
☑ "Usage figures say how old they are": a draft for 3 weeks
Close 2Not nowother…

What the desk can be connected to.

Each of these is off until you turn it on. The docs have the setup for every one.

treacle slack connect

Talk to the desk from a Slack channel. One bot token, no public address: the host polls the channel. Setup opens a prefilled app manifest, picks the channel and waits for you to say something, so only you reach the desk. Digests post the most blocking item, with reply words (accept, close, snooze, more) and quiet hours.

scheduled jobs

An instruction to the desk plus a daily time, some weekdays, or an interval. Set them from the board's scheduled fold or by asking the desk. A job never types into the desk mid-turn; it waits up to 30 minutes, then tells you it gave up.

/hooks/linear · /hooks/github

A new Linear issue, a GitHub review request, a failed Actions run or a new GitHub issue can draft a board task or tell the desk in one line. Every call is signature-checked, replays are dropped, and the event text is marked as untrusted wherever it lands.

host

A minute-by-minute record of memory, swap, CPU and disk on the Mac, with each process attributed to the session that started it. One push when things get tight, another when they recover. Suggestions, such as removing merged worktrees or clearing a cache, come as cards and are re-checked before they run.

second opinion

When a task reaches review, a different agent reads its diff read-only and pins its concerns to the card, each with a severity, file and line, and sends them to the session that wrote the change to act on. Codex reviews Claude's work and Claude reviews Codex's, by default. Nothing waits on it.

⌘⇧D

Delegate. The selection or clipboard becomes a task, drafted, promoted and started from the worktree on screen, after one confirm sheet. The Dock menu has "Delegate from clipboard" too.

task model and skills

A task can pick its model, carry screenshots into its session and grant it global skills. When its work lands, its worktree is offered for removal.

Agents that run on their own, and report back.

An agent is a set of instructions you write once and run whenever you want: a dependency sweep, a release-notes draft, a triage pass over new issues. Each run is a real session in a worktree of its own, or in a scratch folder when the agent works on no repo, so you can open it, watch it and stop it like any other. A Claude Code or Codex run ends by filing a report, which goes to the desk, your phone or both, as you set it.

One page for every agent you keep.

The Agents page shows what is running, what ran in the last day and what failed, with a red line at the top for any agent that is paused or whose last run failed. A run waiting on you is marked in its row. Each agent has its trigger, what it runs as, its last fourteen runs as a spark, and when it last went.

Open one and its definition reads as one sentence of pickers: which agent, which account, how much it may do on its own, which repo, where its output goes, and for Claude Code which model and how hard it thinks. Under that are the instructions, with {{variables}} filled in at run time.

Every save is a new version and every run records the version it ran, so "it worked last week" is something you can check. Run it from the page, and ask the desk when you want a one-off of its own.

Treacle⋮
9:41▰▰▰

agents

5 agents+ new
1running
9last 24h
1failed
release-notes: last run failed, timed out
dependency-sweepmanual · claude · plan · harbourrunning
release-notesmanual · claude · auto · harbourfailed
triage-new-issuesmanual · claude · accept edits · tidepoolneeds you
reportedrelease-notes v3· 6m 12s · 41k tokens
Drafted notes for 2.8.0 from 14 merged PRs. Two breaking changes flagged at the top, the invite rate limit first.
docs/release-notes/2.8.0.md · PR #121
Open sessionDiffRerun on v3

A real session, not a black box

A run starts the way a board task does: a worktree of its own (or a scratch folder for an agent with no repo), the agent CLI you picked, and a brief it reads first, kept out of git. Open its session, stop it or rerun it, and read its diff when it ran in a worktree.

A report you can trust

A Claude Code or Codex run ends with agent_report: an outcome, a summary and links. A run that times out, ends a turn without reporting, or loses its session is marked as such by a supervisor, never left looking busy.

Input is data, never orders

Whatever a run is handed goes into its brief as a fenced block of data the input can't break out of. An agent only gets the grants you gave it, such as web access, and nothing that asks is pre-allowed.

The agent you pick

A run uses the launcher you choose and its account, and on Claude Code its model and effort too. Beyond Claude Code and Codex, treacle's sessions take Gemini, OpenCode and Copilot through the Agent Client Protocol, each with a timeline, a status lamp and its permission asks as cards.

One-off jobs for the desk

Ask the desk for something that doesn't belong to a repo, like a check across every project, and it runs it as a one-off and hears the report when it lands.

On the phone too

The Agents page is a tab on the phone. A run that needs you sends a push like any session, and an agent set to report by push sends its report as a notification you can open.

It remembers what you decided, and asks first.

Every session used to start from nothing. Now a Claude Code session in a project you have filed under a context (personal, work or a client) starts with a short brief of what was decided and learned there, and looks up the rest as it needs it. The memory is a folder of Markdown notes on your own machine, and nothing goes into it until you say yes.

Notes that link, sessions that read them.

The vault lives in ~/.treacle/memory: plain Markdown with [[wikilinks]], so Obsidian opens it as it is. Notes link to the project they belong to, the decision they rest on, and the note they replace, and sessions walk those links when they need more than the brief.

A session can offer what is worth keeping: a decision and why, a fact about the project, a preference you stated. When a board task finishes, treacle also reads its conversation and drafts offers of its own. Each offer is a card. Yes files it, no drops it.

Notes are kept by context: personal, work, and one per client. A session sees the general notes and its own context, never another client's. Offers are checked for keys and tokens, and one that looks like a secret is refused. The check is best-effort, so the card is still where you catch anything else.

Treacle⋮
9:41▰▰▰
‹
harbour : hbr-224-invite-expiryExpire unused invite links
working
what treacle remembers · harbour decisionInvite limits live in the token bucket, not in nginx [[rate-limiting]] factStaging resets its database every night at 02:00 preferenceOne migration per PR, never squashed with code
●memory_related "rate-limiting"
claude
The bucket already tracks each invite's last use, so expiry can read it there instead of adding a column.
remember this?
Invite expiry reads the bucket's last-use time
decision · because [[rate-limiting]] · harbour
Yes, keep itNoother…

The same app, wherever you are.

It is one web app on your own machine. Chrome installs it as a desktop app with its own window and a Dock badge, Treacle for Mac gives it a native window, and your phone adds it to the home screen. They all reach the same server, through your own Cloudflare domain or your tailnet, so you can pick up on one exactly where you left off on another.

9:41▰▰▰

treacle

7 worktreesboard🔊🔔
needs you1
harbour : hbr-212-rate-limit-invitesRate-limit invite links↳ claude · harbour3m ago
✕
Commit and open the PR?
HBR-212 is done. Type-check, lint and 1,212 unit tests are green.
Yes, open itAmend the last commitother…
›harbour213 worktrees
hbr-212-rate-limit-invitesHBR-212PR #114
Rate-limit invite links3m

On the phone, the whole app. The inbox and its buttons, every session's feed, the board, worktrees, the terminal. The compose box types straight into the pane, so iOS dictation just works, and a mic button sends audio to whisper.cpp on the host.

9:41
Tuesday 8 September
harbour : hbr-212now
Commit and open the PR?
Yes, open it · Amend the last commit
treacle : fold-quiet-folders2m ago
finished a turn — waiting for you
2
the icon counts the inbox

A push finds you, and only when it should. Web Push from your own host, only while the app is closed, only for a session flipping to needs-you, a decision opening, or an agent calling notify. It carries the question and its options. Tapping it opens that session. While the app is open it chimes instead.

claude
Both routes now share the bucket. Do you want the same limit on password resets, or leave it for a follow-up ticket?
0:07
+/leave resets for a follow-up, open the PR●Send

Talk to it. Tap the mic, speak, tap again, and the words land in the compose box for a glance before you send. Audio goes to the host over the sealed link and whisper.cpp transcribes it there. One command installs the model.

Treacle⋮

treacle

7 worktreesboard+ folder🔊🔔
needs you1
harbour : hbr-212-rate-limit-invitesRate-limit invite links↳ claude · harbour3m ago
✕
Commit and open the PR?
HBR-212 is done. Type-check, lint and 1,212 unit tests are green. Nothing is committed yet.
Yes, open itAmend the last commitother…
›harbour213 worktrees
hbr-212-rate-limit-invites3m agofocusedHBR-212PR #114
Adding a per-inviter token bucket, then a 429 with a retry hint.
Rate-limit invite links3m✕
+ tab🗑 delete
hbr-219-webhook-backoff12m agoHBR-219
claude · harbour12m✕

At the desk, a Chrome app. Its own window next to your editor, no address bar, the same inbox and feed and board. Wider, so the worktree cards carry their actions and the terminal view has room.

2

In the Dock, with a badge. The icon counts the inbox the same way the phone's does, and Chrome delivers the same push notifications when the window is closed.

Install app?
Treacle
mini.tail0000.ts.net
CancelInstall

One click to install. The icon at the end of Chrome's address bar. No download, nothing to update by hand: the app updates itself whenever the server does.

Opens on your last view

The app, the board, the desk's conversation and each session's recent history are kept on the device. A cold open draws your last screen at once, dimmed, and the live state replaces it as the host answers, without moving where you were reading or losing what you were typing.

Treacle for Mac

The same app in a Mac window of its own, signed and notarized. It pairs from Host → add a device and reaches the host over the same sealed link a phone uses, so it works from anywhere, not only on your network.

No Tailscale required

A phone or a laptop pairs once with a QR and then talks to the host over a sealed link through your own Cloudflare domain. The route in between only ever sees ciphertext, and the app is never on the internet.

More than one machine.

The Mac you sit at doesn't have to be the only one doing the work. Join a Linux server or a second Mac to it, and its sessions show up in the same window, grouped under its name.

treacle join

Pairs another machine with this one over a sealed link, through the route this host uses: your Cloudflare domain or your tailnet. The route is checked end to end before the join command is shown. A joined machine that falls behind this one's build is marked behind, and treacle hosts update brings it up to date.

Linux, x64 or arm64

The same signed binary for Linux, running as a systemd user service that leaves tmux and every session alone across restarts and updates. The installer checks its signature before it lands.

one window, every machine

Folders and the left navigation group by machine, and you can start a tab on any of them from the app. The host page reads memory, swap, load and disk on Linux as on a Mac, with health ratings sized to the machine.

From curl to a Dock iconthe home screen in one sitting.

Setup is a walkthrough, not a checklist. It ticks off what it can do itself, asks about the two things that edit Claude Code's config, and does not call the host reachable until a device of yours has actually loaded the app. Re-run it after every update; it only changes what changed.

1

Install the binary

One file. It is the server, the CLI, the MCP server and the hooks. The installer puts it in ~/.treacle/bin, links it into /usr/local/bin when it can, and otherwise adds it to your shell's PATH once.

zsh · the Mac that stays on
$ curl -fsSL https://treacle.dev/install | sh pouring treacle ... installed: /usr/local/bin/treacle next, on the machine that stays on: treacle setup
2

Run treacle setup

Six things happen on their own: an access token, a tmux config, the web app, and a background service (launchd on a Mac, systemd on Linux) that keeps the server up across reboots. Then it asks which repos to manage and whether to wire up Claude Code. The last step is the only one that can fail, and when it does, setup walks you through fixing it.

treacle setup
treacle agents on a machine that stays on ──────────────────────────────────────── ✓ Access token generated ✓ tmux config installed ✓ Shell cleanup nothing to do ✓ Web UI embedded in the binary ✓ Background service installed and started ⠋ Remote access setting up the host…
treacle setup · folders
Folders to manage git repos found nearby — the phone lists these ▸ ◉ harbour ~/Dev ◉ treacle ~/Dev ◉ tidepool ~/Dev ◯ dotfiles ~ ↑↓ move · space toggles · a all · enter continues
treacle setup · Claude Code
Wire up Claude Code both are opt-in because they edit Claude Code's own config ▸ ◉ Claude Code hooks status, feed, questions on the phone edits ~/.claude/settings.json ◉ treacle MCP agents push documents, diffs, decisions edits Claude Code's config space toggles · enter applies
treacle setup · remote access
Reach this machine from your phone Your phone pairs with this machine and runs the app over a sealed link. All it needs is a public address that leads to the pairing door; the app itself is never on the internet. With a Cloudflare account and a domain on it, that address is yours and never changes. It is free apart from the domain. ▸ Use my Cloudflare domain enter to do it · s to skip

The way in from your phone comes last. With your own Cloudflare domain, setup signs you in to Cloudflare, makes one tunnel and one DNS record, and you get an address that never changes. Without one, a temporary address works until the Mac restarts. Already on Tailscale? That works too. Either way it ends with a QR: scan it and the phone pairs. If the Mac you are sitting at is the host, you can skip this and open it on localhost.

3

Open the address it prints

Setup ends with the URL, the token, and a QR code that carries the token in the URL fragment, so the token never reaches an access log and there is nothing to type on a phone. Then it waits, for up to two minutes, until a device of yours has loaded the app, and names the device that did.

treacle setup · done
treacle ✓ host set up ✓ Access token generated ✓ tmux config installed ✓ Shell cleanup nothing to do ✓ Web UI embedded in the binary ✓ Background service installed and started ✓ Remote access https://mini.tail0000.ts.net Access token (also in ~/.treacle/config.json): a3f9…c41e Scan to open it on your phone — no typing: Waiting for a device to open it… (Ctrl-C to skip — the host is already set up) ✓ MacBook ProiPhone reached it over https://mini.tail0000.ts.net Check everything any time with: treacle doctor
4

Install it as an app, then clicktap the bell

In Chrome, the install icon at the end of the address bar puts Treacle in the Dock with its own window and a badge that counts the inbox. On the phone, Share then Add to Home Screen does the same. ClickTap the bell in the header once to allow notifications. The app updates itself whenever the server does.

mini.tail0000.ts.net⋮
Install app?
Treacle
mini.tail0000.ts.net
CancelInstall

Chrome on the Mac: one click, its own window, a Dock icon.

Treacle
mini.tail0000.ts.net
Copy⧉
Add to Home Screen⊞
Add Bookmark☆

Safari on the phone: Share, then Add to Home Screen.

treacle

connectedboard🔊🔔
needs you1
harbour : mainclaude · harbournow
✕
finished a turn — waiting for you

Bell on. The first session to stop shows up here.

TREACLE_REMOTE_PERMISSIONS=1 claude

Per session. Gated Bash calls become Allow or Deny cards in treacle, with the command shown in full.

treacle voice install

Downloads the whisper.cpp base model, about 148MB, into ~/.treacle/models. Needs ffmpeg and whisper-cpp from Homebrew.

treacle update

Checks treacle.dev for a newer build and installs it, hash and signature verified. The previous binary stays for treacle update --rollback.

treacle doctor

Says where every step stands, including which route your phone uses to get in and whether any device has reached the host.

~/.treacle/config.json

Add linearWorkspace and a personal linearApiKey and ticket pills show the ticket's title and status.

How it works, in one picture.

Treacle is a single Bun binary that owns a tmux server and the git worktrees under the folders you register. Agents run in tmux panes it created. The app talks to it over WebSockets and REST with a bearer token, on localhost, inside your tailnet, or from a paired phone over a sealed link. Nothing needs installing beyond it (Treacle for Mac is optional), and there is no server of ours.

The machine that stays on treacle-server, under launchd or systemd

  • tmux on a dedicated server. Tabs are tmux sessions; shells survive restarts and are attachable from any shell.
  • git worktrees under each registered folder, cut and removed by the server itself.
  • SQLite for the timeline of every session, so the feed survives reconnects and restarts.
  • whisper.cpp for voice, so audio never leaves your machines.
Claude Codehooks report status and prompts; the MCP server pushes documents, diffs and decisions; the transcript feeds the feed
Codexits session log feeds the feed; its questions become cards

Any browser you sign in from

  • Chrome app on the desk: its own window, Dock badge, push.
  • Phone on the home screen, with push and dictation.
  • iPad with a keyboard, for the terminal view.
  • The host holds the state. A device keeps a cache to open fast; close one, open another, same place.

One binary, one directory. The server, CLI, MCP server and hooks are the same executable. State lives in ~/.treacle.

Survives the things that happen. Restart the server and the tmux sessions are still there; the app reconnects and the timeline replays from SQLite.

Honest lamps. With hooks, a lamp flips to needs-you the moment Claude waits. Without them, the pane heuristics still give you working and idle.

Subject lines by a small model. Each active worktree carries one line about what is going on, written from the newest session, refreshed at most every half hour.

Files in. The + in the compose bar uploads a photo or file to the host and types its path into the prompt. You press Enter.

Previews out. An agent can proxy a dev server on the host into the session feed as a capability URL that lives for about six hours.

How it compares, honestly.

Several good tools run coding agents in parallel or put them on your phone. They make different bets. Here is where each one stands, from their own documentation, as of October 2026.

TreacleClaude Code Remote ControlConductorVibe KanbanClaude SquadHappy
What it isA web app over the tmux and worktrees on your Mac or Linux boxAnthropic's way to continue a local Claude Code session from the Claude appA native Mac app for parallel agentsA kanban board that runs agents, in the browserA terminal UI over tmux and worktreesA mobile and web client that wraps the agent CLI
AgentsClaude Code, Codex; Gemini, OpenCode and Copilot over ACP; anything else in a terminal tabClaude CodeClaude Code, Codex, Cursor, OpenCodeClaude Code, Codex, Gemini CLI, OpenCode and moreClaude Code, Codex, Aider, Gemini and moreClaude Code, Codex
Every session on one screenYes, grouped by repo and worktree, with an inbox of what needs youA list; one session at a timeYesYes, as cardsYes, in the terminalA list; one session at a time
A worktree per task, made for youYesNoYesYesYesNo
Sessions are tmux panes you can attach toYes, on a tmux server treacle ownsNoNoNoYesNo
Answer questions and permissions from a phoneYes, as cards, with pushYesNoNoNoYes, with push
A task boardYes: a definition of done, a check command, review with a second opinionNoWorkspaces with a diff to review and mergeYes: cards move the agent through the workNoNo
An agent that watches the restThe desk: digests, Slack, scheduled jobs, webhooks; plus agents that run on their own and reportNoNot documentedExposes the board over MCP to other agentsNoNo
How a phone reaches itPaired with your Mac, end-to-end sealed, through your own Cloudflare domain (or your tailnet)Through Anthropic's serversNot built for itNot built for itSSHThrough Happy's end-to-end encrypted relay
HostmacOS (Apple silicon), Linux (x64, arm64)Wherever Claude Code runsmacOSmacOS, Linux, WindowsmacOS, LinuxWherever the agent CLI runs
Source and priceFree binary, source closedPart of a Claude planFree locally, paid cloud workspacesOpen source, community-maintained since 2026Open sourceOpen source

● yes   ◐ partly   ○ no. These tools move fast. If a row is out of date, tell us and it will be fixed.

Pick Remote Control if you run one Claude Code session at a time and want to keep it going from the Claude app, with nothing to install.

Pick Conductor if you want a native Mac app at the desk for parallel agents, including Cursor's, and do not need them on your phone.

Pick Vibe Kanban or Claude Squad if you want open source, a Linux host, or a board or TUI you can change yourself.

Pick Happy if you want one agent session on your phone from any OS, and are happy with a relay in the middle.

Pick treacle if you run several agents at once on a Mac or Linux box that stays on, and want them on one screen at the desk and on your phone. You get a board that holds work to a definition of done, and the real terminal stays one tap away.

Questions people ask first.

Is this a phone thing?

No. Most days it is a Chrome app in the Dock next to your editor. The phone is the same app at the same address, which matters when a session needs you and you are not at the desk. Nothing about it needs a phone.

Does it replace the terminal?

No, it sits on top of it. Every tab is a tmux session on a server treacle runs, and the raw pane is one clicktap away in the app or one attach away in a shell. Anything the app cannot express, you do in the pane, and the feed catches up.

Does anything leave my machines?

No. The server runs on your own machine, your devices reach it over localhost, your tailnet, or a link sealed end to end with keys only your phone and your Mac hold, and treacle.dev serves this page and the download. The phone's route runs through your own Cloudflare account (or a temporary Cloudflare address), which carries ciphertext; it sees that your phone and Mac talk, and when, not what they say. The page the phone opens first is served through that route too. Push notifications travel through the browser vendor's push service, encrypted end to end as Web Push requires; the payload is opaque to anyone but your device. A second machine joined to your desk talks to the host over a link sealed end to end with keys only the two machines hold, so the tunnel that carries it, Tailscale Funnel or Cloudflare, sees ciphertext. The integrations you can turn on talk to their own services only once you connect them: Slack for the desk's channel, Deepgram for streamed dictation, and Linear or GitHub sending webhooks in, which needs a public route such as tailscale funnel. Your agents talk to their model providers as they always do.

How do updates work?

treacle update asks treacle.dev for a newer build and installs it. The download is checked against its published hash and its signature before it replaces anything, and the previous binary is kept, so treacle update --rollback puts it back. The app shows a one-line banner when a newer build exists; on the phone, updating is one tap. "updates": "ask" | "auto" | "off" in ~/.treacle/config.json decides what happens. ask, the default, tells you and waits. auto installs it and restarts the server, but only when no agent is mid-turn. The check is a GET for a public file on treacle.dev that carries no token or identifier, and off turns it off entirely.

Do I have to use Tailscale?

No. On the host itself it works on localhost with no network setup at all. To reach it from your phone, setup offers your own Cloudflare domain first (a free account and a domain; the address never changes), then a temporary address that needs nothing, then Tailscale if you already use it. No ports get opened on any of them: the Mac dials out, and only its pairing door is reachable.

Which agents does it work with?

Claude Code gets the most: status hooks, permission cards, the MCP tools and the transcript-backed feed. Codex sessions have a feed and their questions become cards. Gemini, OpenCode and Copilot run through the Agent Client Protocol, with a timeline, a status lamp and their permission asks as cards. Anything else runs in a plain Terminal tab with the raw tmux mirror. With both installed, each one gives a second opinion on the other's work when a task reaches review.

Where is the full reference?

On the docs page: every command, every config.json key, the MCP tools agents get, the webhook formats, and the limits. The source is closed, so the docs are the reference.

What if the agent asks something a card can't answer?

Every card has an "answer in your own words" box, and the compose bar types into the pane. A multi-part question opens in the session and is answered part by part. Interactive commands open the terminal instead.

What happens if I ignore a permission card?

After two minutes, or if no treacle client is connected, the normal terminal prompt takes over. Nothing is auto-approved. Dismissing a question tells the agent it was dismissed, not answered.

Linux? Intel Macs? Windows?

Linux, yes: x64 or arm64, a cloud VM or a Raspberry Pi on a 64-bit OS, as a host or as a machine joined to your desk. It runs as a systemd user service, and keys you paste are kept in a file only your user can read instead of a keychain. Intel Macs, no. Windows, through WSL 2 with systemd turned on; there is no native build. The client side is any browser that can install a web app.

What does it cost?

Nothing. Treacle is free to use, personal or commercial, on machines you own or administer. The source is not open and the binary may not be rehosted. Point people here instead.

Your code never leaves your machines, because there is nothing for it to leave to.

Treacle has no backend, no accounts, no telemetry. treacle.dev serves this page and the download. That is everything it can see.

Run more agents than you can watch.
Then watch them anyway.

$ curl -fsSL https://treacle.dev/install | sh