
omux
Native macOS terminal for running multiple Claude Code sessions side by side. AI coding agent manager with projects, live agent status, resumable conversatio…
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 omux (release-binary project) into my current project. Found on https://claudeers.com/omux Repo: https://github.com/onurozcan/omux Homepage/docs: — Detected install method: release-binary → inspect the README Category: automation. Platforms: cli, api. 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.
Grab the latest release asset from GitHub.
# download a build from https://github.com/onurozcan/omux/releases
git clone https://github.com/onurozcan/omux
// compatibility
| Platforms | cli, api |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | Swift |
omux
A native macOS terminal for running many Claude Code sessions side by side. Sessions are grouped into projects in a sidebar, each one keeps its own Claude conversation across relaunches, and a files panel previews whatever the session is working on.

Built with SwiftUI and SwiftTerm.
Features
- Projects and sessions. A project is a folder plus a default command; sessions live under it in the sidebar. Drag to reorder or move sessions between projects, rename them, and give them colors.
- Conversations that resume. Each session that runs
claudeis pinned to its own session id, so quitting and reopening omux continues the same conversation. - Live status. Each session shows whether Claude is working, needs you or is done, and the Dock badge counts sessions waiting on you.
- Files panel (⌥⌘F). Browses the session's folder and previews Markdown, code and text (with optional line wrapping), images, PDFs, audio, video, and anything else Quick Look can show. File paths mentioned in the session's output are listed at the top; ⌘-click a path in the terminal to preview it.
- Recent conversations (⇧⌘O). Reopen any Claude Code conversation found in
~/.claude/projects. - Usage limits. The sidebar shows your Claude plan's 5-hour and weekly limits (see Privacy).
- Open folders from anywhere. Finder's right-click "Open in omux" service, dropping a folder on the Dock icon, or
open -a omux <folder>. - Themes, terminal font and size, and a quick switcher (⌘K).
Requirements
- macOS 14 or later
- Swift 5.9 or later (Xcode 15+ or the Command Line Tools)
- Claude Code installed as
claudefor Claude sessions; plain shell sessions work without it
Build
./build.sh
open /Applications/omux.app
build.sh builds a release binary, assembles build/omux.app, and then replaces /Applications/omux.app so the Finder service and Dock entry stay registered. It signs with the first "Apple Development" certificate in your keychain, or ad hoc if there is none.
Keyboard shortcuts
| Action | Shortcut |
|---|---|
| New session / new shell / new project | ⌘T / ⇧⌘T / ⇧⌘N |
| Open folder / recent Claude conversation | ⌘O / ⇧⌘O |
| Close session | ⌘W |
| Rename / edit session | ⌘R / ⌘I |
| Restart session | ⇧⌘R |
| Interrupt (Ctrl-C) | ⇧⌘. |
| Continue Claude conversation | ⇧⌘↩ |
| Jump to session | ⌘K |
| Next / previous session | ⇧⌘] / ⇧⌘[ |
| Session 1–9 in the current project | ⌘1 … ⌘9 |
| Files panel | ⌥⌘F |
Privacy
omux has no telemetry and makes one kind of network request:
- Usage limits. To show your plan limits, omux reads Claude Code's login from the macOS Keychain (the
Claude Code-credentialsitem, via/usr/bin/security) and sends it tohttps://api.anthropic.com/api/oauth/usage, the same endpoint Claude Code's/usagecommand uses. The token is never written to disk or logged. This endpoint is undocumented and may change or stop working at any time.
Local files omux touches:
~/Library/Application Support/omux/workspace.json: your projects and sessions (plus a.bakcopy).~/.claude/projects: read to list recent conversations and to check whether a session's conversation exists.- Settings are stored in the standard macOS preferences.
Disclaimer
omux is an independent project and is not affiliated with or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic.
License
// faq
What is omux?
Native macOS terminal for running multiple Claude Code sessions side by side. AI coding agent manager with projects, live agent status, resumable conversations and file previews. Built with SwiftUI.. It is open-source on GitHub.
Is omux free to use?
omux is open-source under the MIT license, so it is free to use.
What category does omux belong to?
omux is listed under automation in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/omux)
// retro hit counter
[](https://claudeers.com/omux)
// reviews
// guestbook
// related in Automation & Workflows
The API to search, scrape, and interact with the web at scale. 🔥
🌐 Make websites accessible for AI agents. Automate tasks online with ease.
Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop