What is omux?
omux is a native Mac app for running Claude Code and Codex sessions together in one terminal. It gives developers a dashboard for projects, agent activity, approvals, and parallel coding work, while keeping each session’s conversation available after a relaunch. The app runs on Apple Silicon Macs with macOS 14 or later, uses the Claude Code or Codex CLI already installed on the machine, and is free and MIT-licensed.
omux Features:
Project Sessions: Group terminal sessions by project, arrange sessions as panes or tabs, and switch between them with a quick search.
Live Session Status: See whether Claude Code and Codex sessions are working, finished, waiting for you, or failed, with notifications for unattended requests.
Approval Controls: Allow or deny Claude Code permissions and Codex approvals from the session header or sidebar, and respond to agent questions there.
Isolated Worktrees: Start a session in its own Git worktree and branch, with an optional setup command to prepare its working folder.
Review and Pull Requests: Inspect session diffs, send line-specific review notes to an agent, and, with GitHub CLI installed, view checks and reviews or create and merge pull requests.
Remote Sessions: Run project sessions on another machine over SSH, where they keep running if the Mac sleeps or omux quits; remote Linux is supported on Intel and ARM.
Files and Browser: Preview and edit project files, open a session’s local server in a browser panel, and send selected page elements to the agent.
omux Benefits:
Less Tab Checking: A shared view of session activity and notifications makes it easier to focus on active work instead of repeatedly checking each terminal.
Safer Parallel Work: Separate branches and folders help prevent concurrent agents from overwriting one another’s changes in the same working directory.
Faster Responses: In-place approval controls let you deal with agent requests without first locating and switching to the correct terminal.
Smoother Handoffs: Resuming the exact conversation after reopening means developers can return to an ongoing task without reconstructing its context.
Clearer Code Review: Diffs and line-level notes keep feedback tied to the changes, making it easier to direct an agent’s next edits.
Use Cases:
Parallel Coding Tasks: Have Claude Code or Codex handle several independent changes in one repository while keeping each task in its own worktree.
Agent Supervision: Monitor multiple coding sessions during a workday and respond when a session pauses for a permission or question.
Pull Request Review: Check an agent’s branch diff, leave targeted feedback, and track pull request checks and reviews from the project session.
Remote Development: Start coding-agent sessions on an SSH-accessible Linux machine and let them continue while your Mac is asleep or the app is closed.
Local App Testing: Open a local server started by a coding session, inspect the page in omux, and send a selected element to the agent for changes.

