What is AuraMux?
A terminal app for macOS. It keeps every task in its own tab,
brings them all back after a restart, and marks the ones waiting
on input. It is free and currently in beta.
What is Beam?
Added in 1.9.0. Beam streams one tab, live and view only, to a
link anyone can open in a browser: no install, no account.
Viewers enter a name, plus a short access code you share
separately, and appear in your watch list with a generated
avatar. Stop beaming and the link dies for everyone, forever.
Is Beam secure? Can the server read my terminal?
No. Beam is end to end encrypted. The key travels in the part
of the link after the #, which browsers never send to any
server, and the access code is mixed into the encryption keys.
The relay in the middle forwards ciphertext it cannot read, and
stores nothing. Before anything goes live the app also shows a
plain-words consent warning, because a terminal can print
secrets, and every beam stops itself after an hour unless you
lift the limit.
Can someone watching a beam type into my terminal?
No. The protocol simply has no message that carries input, so
watching is view only by construction, not by a setting.
Remote control may come later, as a separate explicit grant
you approve per person.
Who is it for?
Anyone running several long-lived terminal sessions at once,
usually with AI coding agents in some of them, who wants to
see at a glance which one has finished and which is waiting.
If you work in one or two windows at a time, you will not get
much out of it.
Will it tell me when Claude Code needs me?
Yes. Claude Code rings the terminal bell when it finishes or
needs an answer, and AuraMux turns that into a badge on the tab.
Claude Code only enables that automatically in a few terminals,
so on first launch AuraMux offers to set it up for you. It adds
one key to ~/.claude/settings.json, backs the file up first,
leaves every other setting alone, and will not touch a file it
cannot read.
What are notes, and where do they live?
Each tab can hold notes: a to-do, a plan, notes from a call,
written with live styling and checklists that tick when you
click them. They are plain Markdown files saved inside your
project folder under .auramux/, autosaved on the same rhythm as
the terminal, and readable by any editor. Close the tab or
reset the app and the files are still there.
Can I watch a session from another Mac?
Yes. Remote View shows a session running on another Mac on the
same local network, view only: you can read output and scroll
back, but not type. Approval needs a six digit code shown on
the Mac being watched, disconnecting revokes access, and the
viewer verifies which Mac it is talking to. Local network only,
no accounts, no servers.
Why does AuraMux show up as Aura in my Applications folder?
That is expected, and not a sign of a failed install. The app
installs as Aura and the menu bar says Aura, which is what keeps
your passcode, your permissions and your settings working across
updates. Launch it with open -a Aura.
What is the best terminal for Mac?
That depends entirely on how you work, and anyone offering a
single name is guessing at your day. AuraMux is built for one
situation: several long-running sessions on one Mac, often
with AI coding agents, where knowing which one needs you
matters and you do not want to configure anything. If that is
your day, one command tells you. If it is not, it will not do
much for you.
Is there a macOS terminal that restores my sessions after a
restart?
AuraMux does it by default, with nothing to configure.
Sessions autosave every 20 seconds and every one comes back on
launch with its name, its folder, its colour tag and its place
in the list.
What is a good terminal for running Claude Code?
Any terminal will run it. What matters once you have more than
one session going is whether you can tell which one needs you
without checking each tab. Claude Code rings the terminal bell
when it finishes or needs an answer, but only enables that by
itself in a handful of terminals, which is why it often seems
to do nothing at all. AuraMux sets it up for you on first
launch and turns the bell into a badge on the tab it came
from.
Do I have to give up the terminal I use now?
No. It installs alongside whatever you already have and
changes nothing about it. Try it on one project for a week and
keep whichever you reach for.
How do I update it?
Run the same command you installed with, in any terminal
including AuraMux itself. It quits the app for you through the
same path as Command Q, so sessions and scrollback are saved
first, then installs and reopens. Sessions, scrollback, themes,
colour tags, your passcode and your Full Disk Access grant all
carry over. If it has not shut down cleanly within thirty
seconds the update stops rather than overwrite a running app.
Set AURA_NO_RESTART=1 to be asked to quit manually instead.
Does it need Full Disk Access?
No, but it helps. Every shell AuraMux spawns inherits its
security context, so without it macOS prompts the first time any
session touches Desktop, Documents, Downloads or an external
volume. Granting it once quietens that everywhere. Use Aura,
Grant Full Disk Access, which opens the right System Settings
pane, then add /Applications/Aura.app.
What does it ask for on first launch?
Nothing. AuraMux only reads and writes its own data in
~/Library/Application Support/Aura at startup. Folder prompts
appear only when a command you run reaches a protected folder,
exactly as they do in Apple's Terminal. There is no keychain
prompt unless you set a passcode.
What is there to set up?
Nothing. No config file, no prefix key, no plugin manager, no
sign-up. You install it and the session list is already there,
showing each session's name, folder, git branch and state.
How finished is it?
Early. It is in beta, it is not notarized yet, and it is a
personal project rather than a company. I use it every day,
which is how most of the bugs get found. What gets built next
is decided by the people actually using it, so if something is
missing or annoying, please say so.
What does the passcode lock actually protect?
The window, and only the window. It stops someone walking up
to an unlocked Mac and reading what is on screen. It does not
encrypt your saved sessions or scrollback on disk, so it is
not a substitute for FileVault.
What themes are there?
Seven, switchable live with per-colour brightness: Aura, which
is the default, Classic, which is light, Solarized Dark,
Dracula, Nord, a colourblind-safe palette, and No Theme. They
are picked for reading AI CLI output for hours rather than for
screenshots.
Does it support multiple tabs and split view?
Yes. One tab per session with no limit on how many, and any two
of them can be shown side by side with a draggable divider.
Does it run on Apple Silicon and Intel Macs?
Yes, it is a universal build. It needs macOS 14 (Sonoma) or
later.
Is AuraMux free?
Yes, free to download and use.
Does it collect any data?
No telemetry of any kind. The only network request it makes is
checking for a newer version, once a day.
Why does macOS warn about it, and why install with curl?
AuraMux is ad-hoc signed but not notarized yet, since
notarization needs a paid Apple Developer account and that is a
post-beta job. A browser download gets flagged by Gatekeeper.
Installing with curl avoids it because curl never attaches the
quarantine attribute Gatekeeper checks for. Nothing is bypassed
or stripped.