claudeers.
// Automation & Workflows

omux

Native macOS terminal for running multiple Claude Code sessions side by side. AI coding agent manager with projects, live agent status, resumable conversatio…

Actively maintained
100/100
last commit 10 days ago
last release 10 days ago
releases 16
open issues 0

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.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/onurozcan/omux/releases
// or clone
git clone https://github.com/onurozcan/omux

// compatibility

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

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

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.

omux with three projects in the sidebar, a Claude Code session editing a settings page, and the files panel previewing a Markdown plan

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 claude is 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 claude for 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

ActionShortcut
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-credentials item, via /usr/bin/security) and sends it to https://api.anthropic.com/api/oauth/usage, the same endpoint Claude Code's /usage command 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 .bak copy).
  • ~/.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

MIT

// 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.

9 views
★ 130 stars
unclaimed
updated 24 days ago

// embed badge

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

// retro hit counter

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

// 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 omux connects across the ecosystem