Skip to content
Mooj

Install Mooj

Mooj is a local-only parallel agent session manager for macOS. Every task gets its own workspace — with as many terminals, agents, and tools as you can run.

Requirements

Section titled “Requirements”

Mooj requires an Apple Silicon Mac running macOS 13 (Ventura) or later. Intel-based Macs are currently not supported.

Download and install

Section titled “Download and install”

Download the disk image, drag Mooj.app into your Applications folder, and launch it.

Dependencies

Section titled “Dependencies”

Mooj shells out to a few CLI tools and expects them on your PATH.

  • Git — for worktrees, branches, diffs, everything repo-related.
  • tmux 3.3+ — backs the persistent terminal sessions (Mooj uses tmux’s allow-passthrough to survive app restart).
  • GitHub CLI — for creating and reviewing pull requests from inside Mooj.
  • Claude Code or Codex CLI — at least one is required to run agent sessions. Install whichever agent you want as your default; Mooj works with either.

To verify what’s installed and which versions Mooj has detected, open the Dependencies tab in Settings.