payments1m
GPT-5.5 Codex · checkout-redesign
Waiting for approval
$ pnpm prisma migrate deploy
checkout-redesign 2 +125 −33 218 passed 1
Leave the desk.
Keep the agents running.
Droidtty gives you a native Android view into your coding agents, so you can see what they are doing, respond when they need your judgment, and leave the terminal alone until the terminal is actually necessary.
Droidtty2 need you
2 working 3 done
Agents 6Spaces 6
Needs you 2
agent-deck2m
Opus 5.5 · Homepage redesign
Has a question
Which implementation should I use?
Working 2
shepherd5m
Opus 5.5 · Stabilise scheduler retries
Running tests
main 1 +41 −7 tests 1
fx7m
GPT-5.5 Codex · Storage adapter
Editing src/storage/adapter.rs
storage-adapter 3 +107 −25
A terminal tells you everything that happened. Droidtty tells you what matters now.
Coding agents can spend minutes reading files, running commands, editing code, rebuilding projects, and checking their own work. Most of that activity does not require you. Droidtty turns those streams of terminal activity into a simple question: does anything need your attention?
1 needs you
2 working3 done
paymentsnow
GPT-5.5 Codex · checkout-redesign
Waiting for approval
$ pnpm prisma migrate deploy
See the work, not the noise.
The Herd gives you one place to understand every active agent across your machines and workspaces. You can see what each agent is doing, how long it has been running, what changed, whether the tests passed, and whether something needs you without opening a single terminal session.
- AgentWhich harness and which workspace, with its state on the badge.
- TaskThe model it runs and the task Herdr knows it by.
- ActivityWhat it is doing right now, in words.
- Running forHow long it has been at it.
Droidtty2 need you
2 working 3 done
Agents 6Spaces 6
Needs you 2
payments1m
GPT-5.5 Codex · checkout-redesign
Waiting for approval
$ pnpm prisma migrate deploy
checkout-redesign 2 +125 −33 218 passed 1
Working 2
shepherd5m
Opus 5.5 · Stabilise scheduler retries
Running tests
main 1 +41 −7 tests 1
fx7m
GPT-5.5 Codex · Storage adapter
Editing src/storage/adapter.rs
storage-adapter 3 +107 −25
- BranchWhere the work is happening.
- ChangesFiles touched and lines added or removed.
- TestsRunning, passed or failed, from the agent's own runs.
- TerminalsOpen terminals in the workspace, one tap away.
When nothing needs you, Droidtty should disappear.
Mobile is not where you should spend twenty minutes watching an agent think. It is where you should spend twenty seconds answering the question that lets the agent continue.
- Steps the agent took
- 0
- Times Droidtty interrupted you
- 0
Reading files, editing code and running tests is activity. A deploy that needs your permission is attention, and only that reaches your lock screen.
payments Working · 4m
payments Waiting for approval
Running testsfor 4m · checkout-redesign Stop
Working · 7 steps
Read src/payments/checkout.ts
TSEdited checkout.ts
TSEdited webhook.ts
$ pnpm tsc --noEmit
$ pnpm test
218 tests passed. The migration still has to be applied to the development database.
$ pnpm prisma migrate deploy
Running testspnpm test
Reply to Codex…
Droidtty · Ds-MacBook-Pro · nowpayments · Codex wants to deploy
pnpm prisma migrate deploy
Your judgment should not require a shell.
When an agent asks a question or requests permission, Droidtty presents the decision directly. You can understand the context, make the choice, and let the agent continue without recreating your desktop workflow on a six-inch screen.
payments Waiting for approval
Permission required: pnpm prisma migrate deploy
2 files changed+125−33Review
TSsrc/payments/checkout.ts+82−21
TSsrc/payments/webhook.ts+43−12
Codex wants to deploypayments · shell · 16:57
Apply the pending payment_intents migration to the development database.
$pnpm prisma migrate deploy
Affects
prisma/migrations/20261007_payment_intents/migration.sql
Show details Add a note
Deny Hold to allow
agent-deck Has a question · 2m
Which implementation should I use?
Claude Code has a question
API
Which implementation should I use?
1Existing REST endpointReuse GET /api/agents and poll every 5s
2Add GraphQL mutationAdd agentStatus to the schema with a subscription
3Create new RPC endpointNew tRPC router with streaming updates
Send answer
droidtty Done · 38m
Let's support OSC 7501. Here is the spec.
9 commands · 11 edits · 6 other
Read docs/protocol.md
Read bridge/src/terminals.rs
RSEdited program_status.rs
$ cargo test --lib program_status
All 28 parser and store tests pass. Next, wiring it into the hub and the shell PTYs.
RSEdited hub.rs
$ cargo test --test integration
RSEdited integration.rs
$ cargo test
12 files changed+1471−4Review
RSbridge/src/program_status.rs+789
RSbridge/src/hub.rs+224
98 passedcargo test
Reply to Claude Code…
Opus 5.5
Understand how the work unfolded.
Droidtty turns an agent session into a readable timeline of decisions, commands, changes, tests, and results. The raw terminal is still there, but the normal way to understand a session is no longer to reconstruct meaning from thousands of lines of output.
This is the session that added OSC 7501 support to Droidtty's own bridge, including the integration test that failed once before it passed.
Review the result where you are.
When the important output is code, the interface should show code. Droidtty gives changed files and diffs their own native surface so you can understand what the agent produced before deciding what happens next.
- ui/model/Status.kt +14
- ui/home/HomeScreen.kt +16 −9
- ui/programs/ProgramUi.kt +10 −6
- UI/Home/HomeScreen.swift +11 −6
- UI/Programs/ProgramViews.swift +4 −4
- UI/Theme.swift +13
droidtty Diff · Done
KT Status.kt+14 −0 ui/model 1/6
Mark reviewed Wrap Open file
-98,6 +98,20Status.kt
98 }
99}
100
101+/**
102+ * The home card's status line, or null when it would
103+ * only repeat what the section title, the avatar badge,
104+ * the corner time or the chips already say.
105+ */
106+fun Workspace.cardLine(): String? {
107+ val a = primaryAgent
108+ return when (bucket()) {
109+ Bucket.Working -> a?.task?.activity
110+ Bucket.Done -> a?.task?.result
111+ Bucket.Idle -> if (a == null) "No agents"
112+ else a.execution.label()
113+ else -> statusLine(withElapsed = false)
114+ }
115+}
116+
117/** Contextual default tab (SPEC §8) */
-551,14 +559,13HomeScreen.kt
559 }
551− Spacer(Modifier.height(8.dp))
552− Row(verticalAlignment = CenterVertically) {
553− StatusIcon(kind, size = 13.dp)
554− Spacer(Modifier.width(7.dp))
560+ // The avatar badge carries the state
561+ // icon; this line only adds what it
562+ // doesn't say.
563+ ws.cardLine()?.let { line ->
564+ Spacer(Modifier.height(8.dp))
565 Text(
556− status,
566+ line,
567 style = Herdr.type.label,
568 maxLines = 2,
569 )
570 }
And when you need the terminal, it is a real terminal.
Droidtty does not hide the underlying system from you. Every workspace can show the agent's own Herdr pane or open a real shell in the project folder, drawn by Ghostty's terminal engine for correct VT behavior, with a touch layer built for the phone: sticky Ctrl and Alt, Esc and Tab, and a floating arrow pad you can drag wherever your thumb is.
Powered by Ghostty
droidtty Terminal · Done · 38m
Claude Code Shell
d in ~/code/droidtty λ cargo test --test integration
Compiling droidtty v0.1.0 (bridge)
Finished `test` profile in 4.21s
Running tests/integration.rs
running 3 tests
test end_to_end_demo ... ok
test program_status_end_to_end ... ok
test revoke_from_cli_closes_socket ... ok
test result: ok. 3 passed; 0 failed; in 6.87s
d in ~/code/droidtty λ git status --short
M website/src/pages/index.astro
d in ~/code/droidtty λ
Built around Herdr, rather than bolted onto it.
Droidtty does not guess what an agent is doing by scraping text from the terminal. Herdr already knows your workspaces, their panes and each agent's state, and the bridge reads that alongside each agent's structured session log and the workspace's git history. Together they become workspaces, agents, tasks, questions, approvals, diffs and events that Droidtty can represent directly instead of reverse-engineering from ANSI output.
Agent semantics
Claude Code · Codexyour agents, running on the host
Herdrworkspaces, panes and agent status over its socket API
droidtty-cliadds session logs and git: attention, approvals, questions, tasks, diffs, events
HMP v1 · pinned TLS Droidttyon your phone
approvals and answers go back through Herdr's API, never typed into a terminal
Terminal semantics
Shell or agent panea PTY the bridge owns, or a Herdr pane mirror
bytes Ghostty enginelibghostty-vt parses VT on the phone
Terminal tabtouch keys, arrow pad, physical keyboards
Even ordinary terminal programs can tell Droidtty when they matter.
Droidtty supports the Program Status Protocol, OSC 7501, so command-line tools can report whether they are working, blocked, finished, or failed without Droidtty trying to interpret their screen output. A build can show its progress, a deploy can ask for permission, and a long upgrade can tell you it finished, all from a shell you opened in Droidtty.
printf '\e]7501;state=working:app=cargo:progress=82:msg=%s\e\\' "$(printf 'Compiling droidtty-core' | base64)"printf '\e]7501;state=blocked:kind=permission:app=terraform:msg=%s\e\\' "$(printf 'Apply 3 to add, 1 to change?' | base64)"printf '\e]7501;state=blocked:kind=permission:id=deploy/eu-west\e\\'printf '\e]7501;state=done:app=brew:msg=%s\e\\' "$(printf 'Upgraded 12 packages' | base64)"- Herdr
- rich agent semantics
- OSC 7501
- generic program status
- Ghostty
- terminal semantics
States are idle, working, blocked (permission, question or auth), done and error. Working and blocked end at the next shell prompt; done and error stay until you have seen them. A program's status never overrides what Herdr says about an agent.
Needs you 2
Terraform12s
production · Mac Studio
Needs permission
Apply 3 to add, 1 to change?
Deploy1m
rewind · Ds-MacBook-Pro
Deploying v2.4.1
Needs permission
1 action needs attention
EU West · Approve production deploy?
Working 1
Cargo0s
droidtty · Ds-MacBook-Pro
Compiling droidtty-core
82%
droidtty — zsh
Done 1
Brew4m
mac-studio · Mac Studio
Upgraded 12 packages
Your phone is the control surface, not the workstation.
Droidtty is designed for the moments between focused work: walking to lunch while an agent runs tests, leaving the laptop behind while a build finishes, or answering one question that would otherwise leave a task blocked until you return.
DroidttyNothing needs you1 needs you
Agents
shepherd
Opus 5.5 · Stabilise scheduler retries
Running tests
312 tests passed; retry jitter is now capped at 30s.
agent-deck
Opus 5.5 · Homepage redesign
Editing src/app/page.tsx
Has a question
fx
GPT-5.5 Codex · Storage adapter
Editing src/storage/adapter.rs
Running cargo clippy
Let the agents work.
Droidtty will tell you when they need you.
Get Droidtty for Android
Droidtty is in early access. The bridge that connects it to Herdr is published today; it runs next to Herdr on the machine where your agents work, and the app pairs with it by scanning a code.
- 1 Install the bridge where Herdr runs.
Prebuilt for macOS on Apple Silicon; more platforms are on the way.npm install -g @droidtty/cli - 2 Start it and print a pairing code.
No agents running yet?droidtty-cli serve droidtty-cli pairdroidtty-cli serve --demostarts a simulated herd you can explore. - 3 Scan it with Droidtty.The Android app is shared with early testers while it is in preview, and an iPhone version is in TestFlight beta. Pairing pins the bridge's certificate, so your phone only ever talks to your machine.