claudeers.
// Automation & Workflows

ClaudeTTY

Bloat-free, fast cmux for Claude on MacOS.

// Automation & Workflows[ cli ][ api ][ web ][ claude ]#claude#ai-agents#anthropic#claude-code#cmux#developer-tools#ghostty#libghostty#automation◷ NOASSERTION$open-sourceupdated 25 days ago
Actively maintained
100/100
last commit 14 days ago
last release 15 days ago
releases 6
open issues 1

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up ClaudeTTY (claude-plugin project) into my current project.
Found on https://claudeers.com/claudetty
Repo: https://github.com/aqilc/ClaudeTTY
Homepage/docs: —
Detected install method: claude-plugin → /plugin install claudetty@aqilc/ClaudeTTY
Category: automation. Platforms: cli, api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add aqilc/ClaudeTTY
/plugin install claudetty@aqilc/ClaudeTTY
// or clone
git clone https://github.com/aqilc/ClaudeTTY

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseNOASSERTION
Pricingopen-source
LanguageSwift

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

ClaudeTTY ClaudeTTY

A fast, undying cmux for Claude Code.

Download for Mac
macOS 26 or later, Apple Silicon

ClaudeTTY with five groups in the sidebar and Claude working in two tabs

Features

The app is killed and reopened with every tab still running

Persistent Tabs

Every tab runs in a zmx session outside the app, like tmux without the tmux. Quit it, crash it or update it, and every Claude is still mid-edit when it opens again. Same when Claude Code updates itself. The Claudes you already had open stay up and still get tracked. After a reboot each tab comes back in its group with claude --resume.



The tab dots for each activity

The dots

Each tab's dots move differently depending on what its Claude is doing and turn amber when it's waiting on you, so with 4 Claudes in a group you can tell which one needs you. Tabs also show how much context they've used.



A group split into panes, each with its own tab bar

Groups and panes

I keep each project in a group and its Claudes as tabs. Groups can be colored, pinned and put in folders. Splits and shortcuts are the ones you know from iTerm, and ⌘-click opens links and file paths even while Claude Code has the mouse.



Editing the source, running install.sh, and the open app switching to the new build

Modding it

The whole app is about 5,500 lines of Swift in three files, so it's pretty easy to mod. Change something (or ask Claude to), run ./install.sh and the open window switches to the new build like magic, tabs and all.



Dragging the sidebar edge shut, open again and shut again in one drag

Dragging the sidebar shut

Satisfying. ⌘B for less satisfaction but some more practicality.



Smaller Things I Like

  • Click "3 agents" under a group and pick one, and that subagent's transcript opens in a pane right next to its Claude, live. Pretty fun to watch them work.
  • Drop a screenshot on a Claude tab and it attaches as [Image #1], same as Claude Code's own paste, and other files go in as @ mentions. ⌘V on a copied image works too.
  • The menu bar icon shows you how many tabs want your input, so I close the window but can come back when I remember instead of being constantly bothered.
  • Idle groups show the last thing their Claude said and how long ago, which is usually enough for me to remember what I was even doing there.
  • The dots wait a quarter second before switching, so a Claude flying through a bunch of quick file reads doesn't turn into a strobe light.
  • ⌘P ↩ takes you back to the tab you were just in, basically ⌘Tab for tabs.
  • ⌘⇧T reopens the tab you just closed, like in a browser, and if it had a Claude in it you get that same Claude back. Pretty handy when you close the wrong one.
  • Right-click a tab to schedule a message, like a prompt for when your limits reset.
  • If you answer a permission prompt from somewhere else, the notification goes away on its own instead of sitting there forever.
  • The close dialog lists what's still running in the tab and for how long.

Compared to cmux and Others

ClaudeTTYcmuxSupersetWarpWaveGhostty
Tabs keep running after a quit or crash✅only through tmux✅❌SSH only, opt-in❌
Shows what each Claude is doing✅a needs-attention ringworking and donewith its plugin❌❌
Claude can run other tabs✅CLI and socketCLI, MCP and SDK❌wsh CLI❌
Memory with one idle tab68 MB1,029 MB (15×)359 MB895 MB556 MB84 MB
Idle CPU0.03%3.1% (103×)1.9%3.2%1.9%0.7%
Launch to first window307 ms701 ms889 ms829 ms1,226 ms302 ms
App size20 MB454 MB1.5 GB872 MB531 MB62 MB

All on my M4 Pro (48 GB) with macOS 27.0 and one window with one tab. Launch is the median of 5, memory is Activity Monitor's footprint 20 s after launch (ClaudeTTY's includes the zmx process holding the tab) and CPU is over the 30 s after that. cmux 0.65.2, Superset 1.39.0, Warp 0.2026.10.14 and Wave 0.14.5 on fresh profiles, Ghostty 1.3.1. Without tmux, cmux reopens your layout and restarts Claude into its last conversation, but whatever was running is gone (cmux README).

Letting Claude Run Your Tabs

ClaudeTTY installs a Claude Code plugin and a ct command, so the Claude in one tab can open, watch and steer the others:

ct list                          # every tab, its group, folder and Claude state
ct web dev bun run dev           # open tab "dev" in group "web", running a command
ct split dev right agent claude  # a new pane beside it with Claude in it
ct wait agent idle               # block until that Claude is done
zmx send agent "run the tests"   # type into it

Don't even look at this, this is meant so your Claude has fine grained orchestration abilities and can accept prompts and other things for you without you ever having to step in. My terminal teaches it to Claude automatically, in as few tokens as possible (~75 to be exact).

Install

Download ClaudeTTY.dmg, open it and drag ClaudeTTY to Applications.

Build from source

You need Xcode and Zig 0.16 (brew install [email protected]).

./deps.sh     # builds GhosttyKit from pinned, patched Ghostty source and fetches zmx
./install.sh  # builds and signs ~/Applications/ClaudeTTY.app

install.sh signs with your Apple Development identity if you have one and otherwise offers to make a local one, so macOS remembers the app's permissions between builds. It also restarts the app, everything running as it was.

Limitations

I think it's pretty much done, so apart from bugs and small niceties I won't be adding much. If you need something else there's probably a terminal tool for it, like terminal-browser for the web or ttt (I used vim anw). And since ClaudeTTY is fast they run better here than in a lot of dedicated GUI apps, even cmux. Ask your agent to add the functionality you need for those tools.

Pull requests are off for the same reason. If you want it to do something else, fork it and change it. Bug reports and cool feature requests that land with my philosophy in Issues are welcome.

License

CC BY-NC-SA 4.0

FAQ

Why make another terminal?

I used cmux for a while and loved the layout, but it was buggy for me. It crashed a lot, updates killed everything I had running (which hurts when Claude's in the middle of an edit), it leaked memory and it'd pile up a bajillion unread notifications that didn't even work properly. It also only really tracks one Claude per workspace.

So I kept the parts I liked, groups in the sidebar and tabs in the titlebar with the same shortcuts, and left out the browser, file viewer and port lists since I barely opened them. I let Claude write the code and only step in for an edit now and then, so I don't need a file tree or an editor either. Edits I would make also feel worthless since they're just normal code anyways, so it's going to get replaced eventually.

// faq

What is ClaudeTTY?

Bloat-free, fast cmux for Claude on MacOS.. It is open-source on GitHub.

Is ClaudeTTY free to use?

ClaudeTTY is open-source under the NOASSERTION license, so it is free to use.

What category does ClaudeTTY belong to?

ClaudeTTY is listed under automation in the Claudeers registry of Claude-compatible tools.

8 views
★ 20 stars
unclaimed
updated 25 days ago

// embed badge

ClaudeTTY on Claudeers
[![Claudeers](https://claudeers.com/api/badge/claudetty.svg)](https://claudeers.com/claudetty)

// retro hit counter

ClaudeTTY hit counter
[![Hits](https://claudeers.com/api/counter/claudetty.svg)](https://claudeers.com/claudetty)

// reviews

// guestbook

0/500

// related in Automation & Workflows

🔓

The agent that grows with you

// automationNousResearch/⟨Python⟩★ 264,763◷ MIT[ claude ]
🔓

The API to search, scrape, and interact with the web at scale. 🔥

// automationfirecrawl/⟨TypeScript⟩★ 199,533◷ AGPL-3.0[ claude ]
🔓

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

// automationbrowser-use/⟨Python⟩★ 121,235◷ MIT[ claude ]
🔓

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

// automationLeonxlnx/⟨JavaScript⟩★ 110,676◷ MIT[ claude ]
→ see how ClaudeTTY connects across the ecosystem