A native macOS terminal multiplexer for coding agents

Any agent.Any workflow.

Toastty gives your agents building blocks they can drive. Shape them into the workflow that fits how you work, with any agent that runs in a terminal.

Download for macOS

Free and open source · macOS 14+ · Built on Ghostty

lumen1/2

main

Plan checkout redesign

Waiting for your input

Fix flaky auth test

Ready for prompt

⌄ TASK SPACES 1

checkout-redesign

Reading handoff…

PR #128 0m 04s

docs-site0/1

Update API reference

Ready for prompt

infra0/1

Rotate staging keys

Needs approval: apply plan

approval

+ New workspace

lumen1 running

mainreview

Claude Code

● Published Scratchpad "Checkout mockup" (rev 3).

Summary card moves above payment; totals stay

pinned while scrolling on mobile.

● Plan agreed. Ready to build when you are.

› hand this off to a worktree and verify it visually

● Skill(worktree-create)

⎿ Wrote WORKTREE_HANDOFF.md

⎿ Created worktree on feat/checkout-redesign

⎿ Forked this session into a new task space

⎿ Copied the checkout mockup to its right panel

● Handed off. The task space owns the build and the PR.

›

● Read WORKTREE_HANDOFF.md

⎿ Goal, 4 decisions, 3 checks, mockup rev 3

● Edit src/checkout/SummaryCard.tsx +86 −41

● Edit src/checkout/CheckoutPage.tsx +12 −30

● Bash(npm test)

⎿ ✓ 214 passing (38s)

● Screenshot checkout at 390px and 1280px

⎿ Opened the handoff in the right panel

● Published verification report: 3/3 checks passed

● Opened PR #128 feat/checkout-redesign → main

● Ready for your review.

›

● Bash(npm run dev)

⎿ Docs preview at localhost:3000

● Preview is open in the right panel.

› Annotation 1 on localhost:3000/docs/webhooks

"Still shows the v1 payload. Update for v2."

[screenshot of the marked region]

● Edit docs/api/webhooks.md +34 −12

● Reloaded the preview. The payload section is v2.

›

◧ Checkout mockup ¶ WORKTREE_HANDOFF.md ◧ Verification ◎ PR #128 ◎ localhost:3000

Checkout mockupBound to Claude Code

Subtotal$76.00

Shipping$8.00

Total$84.00

Pay

Subtotal$76

Total$84

Pay

① Summary card first on mobile ② Totals stay pinned while scrolling ③ One primary action

localhost:3000/docs/webhooks✎

lumen docsv2

Webhooks

Lumen sends an HTTPS POST to your endpoint whenever something happens in your store.

Payload

Each event sends event, timestamp, and a flat payload map.Each event includes id, type, created_at, and a nested data object.

{ "event": "order.paid",
  "timestamp": 1727712000,
  "payload": { ... } }{ "id": "evt_91f",
  "type": "order.paid",
  "created_at": "2026-09-30T16:00:00Z",
  "data": { ... } }

Retries

Failed deliveries retry with exponential backoff for up to 24 hours.

✎Annotating1➤ Send to AgentClear

1

1Add comment

↩ Save ⇧↩ Newline esc CancelAdd

Sent 1 annotation to Codex

Checkout redesign: handoff

feat/checkout-redesign · base main @ 9f3c2e1 · draft PR

Goal

Move the order summary above payment and keep totals visible on small screens, matching mockup rev 3.

Decisions

Summary card is a sticky header on mobile only
Keep the existing Pay button and payment form
No new dependencies
Follow the repo's verification guide

Checks

Summary above payment at 390px
Totals pinned while scrolling
npm test passes

Verification

3/3 passed

checkout-redesign · 2 screenshots · npm test

Subtotal$76.00

Shipping$8.00

Total$84.00

Pay $84.00

390px

Subtotal$76

Total$84

Pay $84.00

1280px

Summary card sits above payment at 390px
Totals stay pinned while scrolling
npm test: 214 passing

github.com/lumen-app/lumen/pull/128

Redesign checkout summary card #128

Openfeat/checkout-redesign → main

✓All checks have passed

4 successful checks

Summary

Moves the order summary above payment and pins totals on mobile.

Verification: 3/3 checks with screenshots

3 files changed · +98 −71

Toastty · nowcheckout-redesign is ready for review
PR #128 · 3/3 checks passed

Example: hand off a task, fix a docs page while it works, come back to a PR.

Building blocks

Everything on screen is something your agent can use.

Toastty is a terminal multiplexer at its core, so it works with Claude Code, Codex, Cursor, Grok Build, OpenCode, Pi, or any CLI you run. What it adds is a set of pieces your agents can arrange for you.

5toastty action run workspace.create · panel.create.local-document · workspace.set-annotation

Workspaces and task spacesOne per project or task, in the sidebar. A task space nests new work under the session that started it.
Tabs and splitsAny terminal layout, with any agent or command in each pane. Layouts persist across restarts.
Right panelScratchpad pages, local files, and a browser beside the terminal: plans, mockups, handoffs, previews.
Status and chipsLive agent status and notifications, plus links like PR #128 or ENG-412 pinned to a workspace.
The toastty CLIEvery piece above, callable from a skill or a script. Skills in ~/.toastty/skills reach every supported agent you launch.

Workflows

Put the pieces together however you work.

A workflow is a short skill file that tells your agent which pieces to use and when. Start from the worktree examples, or describe how you work and let your agent write one.

Worktree handoff

"hand this off"Example included

Packages the conversation into a handoff, opens a worktree in a new task space, and comes back with a screenshot report and a PR chip.

git · GitHub

Issue to PR

"start ENG-412"

Reads the issue, names a workspace after it with a chip linking back, drafts the plan in a Scratchpad, and links the PR on the issue when it's up.

Linear · GitHub Issues

Review queue

"review my PRs"

Opens a task space per requested review with the diff in the browser, writes notes into a Scratchpad, and notifies you as each one is ready.

GitHub

Spec to tasks

"build from this spec"

Opens the spec beside the terminal, splits it into tasks, starts a task space for each, and keeps a progress page up to date.

Google Docs · Notion · Markdown

Crash to fix

"fix this crash"

Reproduces the report in a worktree with the dev server in a split the agent can read, then shows before and after screenshots.

Sentry · logs

Second opinion

"ask another model"

Runs two agents side by side on the same question and compares their answers in a Scratchpad.

Any two CLI agents

The worktree handoff ships as example skills; the others are ideas to describe to your agent. Issue trackers and documents are reached through your agent's own tools, such as MCP servers or gh. Toastty provides the workspace around them.

Sidebar

See what needs you next.

Every workspace is a card in the sidebar. Sessions report live status, and the rows that want you are tinted: green when ready, amber when waiting for approval, red on an error.

Task spacesTask workspaces nest under the session that started them, each with its own status and PR chip.
Jump to what's next⌘⇧A cycles through unread, approval, and active sessions.
Mark for later⌘⇧L flags a session; the flag clears when it moves forward.
OSC 7501 supportPrograms that report OSC 7501 status appear in the sidebar with progress and approval, input, or login labels.You can also watch any command with ⌘⇧M and get notified when it exits.
NotificationsNative macOS notifications and unread badges, so you can look away.

Rich status for Claude Code, Codex, Cursor, Grok Build, OpenCode, MiMo Code, and Pi. Any process or agent CLI that supports OSC 7501 will provide basic status updates as well.

lumen2/6

main

Refactor cart totals

Running tests…

2m 10s

Plan checkout redesign

Plan agreed. Ready to build.

Migrate orders table

Needs approval: run migration

approval

⌄ TASK SPACES 3

search-filters

Editing FilterBar.tsx

6m 41s

checkout-redesign

Ready for review

PR #128

✓

sidebar-icons

Merged

PR #121

docs-site0/1

Update API reference

Waiting for your input

⚑

OSC 7501 example1/2

Deploy v2.4.1

Uploading images to 3 regions…

65%

Rotate staging keys

terraform plan failed

error

Right panel

Context beside the terminal.

Each tab keeps its own right panel. Agents open what you need to see, and you can open things there too.

◧ Architecture

Scratchpad

Agents publish HTML pages for plans, mockups, diagrams, and reports. Each one stays linked to the session that made it.

¶ webhooks.md

1# Webhooks

2

3Lumen sends an HTTPS POST

4whenever something happens.

5

6## Payload

7Each event includes `id`…

Local files

Markdown, code, configs, logs, and CSV open in an editable view with line numbers, right next to the agent working on them.

◎ localhost:3000

1

Browser

Previews, dashboards, and PRs. Mark up a page and send your notes to an agent along with a screenshot.

Toastty Mobile TestFlight beta

Check on your agents from your phone.

The same sidebar, on your iPhone. See which sessions need you, answer the questions your agents ask, and send the next message, all over your private tailnet.

Every session, liveWorkspaces and task spaces with live status. Rows that need you are tinted green, amber, or red, just like on the Mac.
Answer your agents' questionsWhen an agent asks you to choose, pick an option or type a custom answer. It lands in the terminal on your Mac as if you were there.
Reply from anywhereSend the next prompt with photos and files attached. While the agent works, queue a follow-up for the next turn, steer a Codex or Claude Code turn, or stop it.
Scratchpads and filesOpen the pages, documents, and previews your agents published, and tap a PR chip to read the pull request.
Private by designToastty listens only on your Mac, and Tailscale Serve carries conversations over your own tailnet. No Toastty account is needed. Optional iPhone notifications in push-enabled builds send session titles and status through Cloudflare and Apple.

Available through TestFlight for now. Remote Access covers pairing and the tailnet setup.

TOASTTY live · mac-studio +

AllActive

lumen3 sessions

Plan checkout redesign4m

Plan agreed. Ready to build.

⑂ 1

Migrate orders tableapproval1m

Needs approval: run migration

Fix flaky auth test2h

Ready for prompt

TASK SPACES 2/21

checkout-redesign6m 41sPR #128 ↗→

Capturing screenshots…

search-filters1d→

Paused for review

docs-site1 session

Update API reference12m

Updated the preview

Migrate orders tableneeds approval · lumen · Claude Code

1 ›

Add a fulfillment_status column to orders and backfill it from shipments

worked · 4 tool calls

orders has 2.1M rows. A plain ALTER TABLE would lock it for about 40 seconds, right through the afternoon peak.

Questionpending

Approach

How should I run the migration?

Online migrationAdd the column nullable, backfill in batches, then add the constraint

Lock the tableOne ALTER TABLE, about 40s of downtime

OtherEnter a custom answer

Answer every question to continue

Submit answer

You can also answer on the desktop

Claude accepted

ApproachOnline migration

working · 1 tool call

Added fulfillment_status as a nullable column. Backfilling in batches of 5,000 rows…

Backfill done: 2.1M rows in 3m 12s. The constraint is in place and all 214 tests pass.

Then open a PR once CI is green

working · 1 tool call

working · 3s

Queued 1 · sends after this turn

Then open a PR once CI is green

EditRemove

claude-opus-5-5 · high reasoning

Pending request — input paused

Queue

qwertyuiop

asdfghjkl

⇧zxcvbnm⌫

123spacereturn

checkout-redesign

in lumen

PR #128 ↗feat/checkout-redesign

SESSIONS 1/1All ⌃

Checkout redesign2m

Ready for your review.

PANELS 2

VerificationScratchpad · 2m

WORKTREE_HANDOFF.mdDocument · 24m

DonePR #128

github.com/lumen-app/lumen/pull/128

Redesign checkout summary card #128

Openfeat/checkout-redesign → main

✓All checks have passed

4 successful checks

Summary

Moves the order summary above payment and pins totals on mobile.

Verification: 3/3 checks with screenshots

3 files changed · +98 −71

9:41

Example: answer a question from the train, queue the next step, and come back to a PR.

Get started

Set up in a few minutes.

Download Toastty

Open the latest release and drag Toastty to Applications. Your Ghostty config carries over.

Paste the setup prompt

Copy it from Toastty ▸ Get Started with Toastty… and give it to any agent in a Toastty pane. It previews every change before writing anything.

Pick a workflow

Copy the worktree handoff examples into ~/.toastty/skills, or describe how you work and let your agent write a skill there.

You are helping me set up Toastty. Please run: "$TOASTTY_CLI_PATH" setup guide Read the guide, narrate each step, dry-run every setup installer first (pass --dry-run), show me the planned writes, and wait for my explicit OK before rerunning anything with --apply.

Foundations

A real terminal underneath.

Ghostty renderingGPU-accelerated, and your existing Ghostty config just works.

Keyboard first⌘⇧P command palette, ⌘D to split, ⌥1–9 to switch workspaces. Full keyboard reference

Terminal profilesOne-key launchers for tmux, herdr, SSH, or any startup command.

Layouts that persistWorkspaces, tabs, and splits come back after a restart, and with shell integration, so does each pane's history.

Local firstNo usage analytics or telemetry. Beyond update checks, Toastty only connects out for features you use, such as Remote Access or a diagnostics report you choose to send.

Make Toastty work your way.

Free and open source for macOS 14 and later.

Download for macOS View on GitHub

Any agent.Any workflow.

Example workflow

Everything on screen is something your agent can use.

Put the pieces together however you work.

Worktree handoff

Issue to PR

Review queue

Spec to tasks

Crash to fix

Second opinion

See what needs you next.

Context beside the terminal.

Scratchpad

Local files

Browser

Check on your agents from your phone.

Set up in a few minutes.

Download Toastty

Paste the setup prompt

Pick a workflow

A real terminal underneath.

Make Toastty work your way.