A CLI app for running and switching between multiple AI coding agent sessions across Git worktrees and projects, without tmux.
onurozcan/omux
A native macOS terminal app for running many Claude Code and Codex coding-agent sessions side by side, with live status and in-sidebar approvals.
- Stars
- 129
- Forks
- 28
- Open issues
- 2
- Last commit
- 11 hours ago
What is it?
omux is a native macOS terminal built in Swift on SwiftTerm, aimed at developers who run several coding agents at once. It groups Claude Code and Codex sessions under projects in a sidebar, shows whether each agent is working, waiting for input, or done, and lets you answer Claude Code permission prompts and Codex approvals with Allow or Deny without switching windows.
Each session keeps its conversation across restarts, and worktree sessions get their own git branch and folder so parallel agents do not touch the same files. Pull request checks, reviews and merge status appear beside the session when the GitHub CLI is installed, and the session's diff can be reviewed with line notes sent back to the agent. The app requires Apple Silicon and macOS 14 or later, and it ships as a signed, notarized download.
Key features
- 01Sidebar groups Claude Code and Codex sessions by project with live working, waiting and done status.
- 02Allow and Deny buttons for Claude Code permissions and Codex approvals directly on each session.
- 03Sessions resume their exact conversation after restart or relaunch.
- 04Worktree sessions get their own branch and folder, with an optional per-project setup command.
- 05Pull request checks and reviews shown next to the session via the GitHub CLI.
- 06Diff review with line notes sent to the agent as a single message.
- 07Split panes, file and Markdown previews, and an integrated browser for local dev servers.
Use cases
- Running eight or more coding agents across several repositories and seeing which one needs input.
- Letting parallel agents work on separate git branches without file conflicts.
- Reviewing an agent's diff and sending line-level feedback before merging.
Quick start
- 1
Download the latest release DMG and drag omux to Applications
- 2
Or build from source and install into /Applications
./build.sh - 3
Open the app
open /Applications/omux.app
Things to know
- Requires Apple Silicon and macOS 14 or later.
- Claude Code and Codex CLI must be installed separately for their sessions.
- Building from source needs Swift 6.2 or later.
In collections
Topics
FAQ
- What is omux?
- A native macOS terminal app for running many Claude Code and Codex coding-agent sessions side by side, with live status and in-sidebar approvals. omux is a native macOS terminal built in Swift on SwiftTerm, aimed at developers who run several coding agents at once. It groups Claude Code and Codex sessions under projects in a sidebar, shows whether each agent is working, waiting for input, or done, and lets you answer Claude Code permission prompts and Codex approvals with Allow or Deny without switching windows.
- Is omux free to use? What license does it have?
- omux is open source under the MIT license. Check the license terms before using it in commercial products.
- Is omux still maintained?
- Actively maintained. The last commit to omux was on Nov 6, 2026.
- What can I use omux for?
- Running eight or more coding agents across several repositories and seeing which one needs input. Letting parallel agents work on separate git branches without file conflicts. Reviewing an agent's diff and sending line-level feedback before merging.
- How do I install omux?
- Download the latest release DMG and drag omux to Applications Or build from source and install into /Applications: ./build.sh Open the app: open /Applications/omux.app
- Where can I get omux?
- The source code and installation instructions are on GitHub: https://github.com/onurozcan/omux
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Local-first desktop workbench that runs multiple coding agents in parallel, each in its own git worktree, with diffs, editor, terminals and PR actions in one window.
A terminal Kanban board that runs multiple coding agents (Claude Code, Codex, Gemini CLI, Cursor and more) in parallel, one git worktree and tmux window per task.
A macOS HUD that shows quotas, token usage and sessions for Claude Code, Codex and 16 other coding agents, with approvals and one-click return to sessions.
A terminal app (CLI/TUI) for running and managing multiple AI coding agents like Claude Code, Codex, and Aider in separate git workspaces.
A native macOS terminal built on libghostty, with vertical tabs, agent-aware notifications and a scriptable CLI for running AI coding agents in parallel.