Mjolnir (mj) is a full-featured frontend for Codex and Claude. It gives both agents the same terminal workflow, team configuration, review pipeline, and remote-control surface.

Features

• Codex and Claude teams: use either agent for coding and review, or split the roles between them without changing tools or workflows.
• Parallel subagents: delegate to as many as 16 write-capable agents in fresh sessions, with live progress and completed reports returned to the primary agent.
• Integrated adversarial review: automatically challenge changed turns with an independent reviewer and targeted specialist checks.
• Worktree sessions: start work in a linked Git worktree and keep agent changes separate from the current checkout, whichever coder you choose.
• Remote control: run the workspace and control plane on your machine while driving the session from another browser or device.
• Local voice input: dictate prompts on macOS, Linux, and Windows with cross-platform, on-device speech recognition.

Terminal

Web interface

Four teams, one shortcut

Choose one of four teams during onboarding, from /mjconfig, or with Ctrl+Tab in a session:

• Codex
• Claude
• Codex coder + Claude reviewer
• Claude coder + Codex reviewer

The coder owns the primary session. The reviewer backs the independent review pass that challenges changed turns, plus the default subagent pool. Switching teams keeps Mjolnir's terminal, permissions, sessions, tools, and remote workflow unchanged.

Mjolnir itself, its remote-control server, transcripts, and workspace tools run on infrastructure you control. Model requests still use the selected provider under its terms and data boundaries.

Requirements

You need credentials for at least one configured model provider. Mjolnir ships with built-in Codex and Claude ACP routes and, on macOS, Linux, and Windows, manages the Node.js runtime those routes need. A system Node.js installation is only required when installing through npm/npx or when using the built-in routes on Android. Provider use may incur cost.

Review the data and trust boundaries before connecting a private repository.

Install

Choose any of the following methods.

Release installer: macOS and Linux on x86-64 or ARM64; Android on ARM64:

curl -fsSL https://raw.githubusercontent.com/BrokkAi/mjolnir/master/install.sh | bash

Homebrew: macOS (Apple Silicon or Intel) and Linux (x86-64 or ARM64 glibc):

brew install brokkai/tap/mjolnir

npm or npx: macOS, Linux, Windows, and Android with Node.js 18 or later:

npm install -g @brokkai/mjolnir
# Or run without a global install:
npx -y @brokkai/mjolnir

crates.io: install the terminal client and desktop voice worker with Rust:

cargo install --locked brokk-mjolnir brokk-mj-voice-worker

Release archive: download the archive for Linux, macOS, Windows, or Android from GitHub Releases.

Build from source:

git clone https://github.com/BrokkAi/mjolnir.git
cd mjolnir
cargo build --release
./target/release/mj --cwd .

Desktop release packages include mj-voice-worker; Android packages omit voice support. See the full installation guide for platform details, upgrades, checksums, and custom install paths.

Run

Open a repository and run:

mj

First launch discovers available provider credentials and asks which team to use. Press Ctrl+Tab to switch teams later, or open the Team tab in /mjconfig. Team, model, and adapter changes apply to a new session.

Try it

The 10-minute evaluation uses a checked-in disposable fixture to exercise a delegated subagent change, its pushed-back report, explicit review, session resume, and headless output without risking a real repository.

For a quick read-only headless check:

mj --print --permission-mode manual "summarize this repository; do not modify files"

Use an isolated worktree for an interactive coding session:

mj --worktree

Documentation

• Teams and adversarial review
• Install and run
• Start with Codex
• Start with Claude
• 10-minute evaluation
• Remote control
• Voice dictation
• Subagents
• Delegation and adversarial review
• Permissions and workspace scope
• Sessions, worktrees, and resume
• Headless automation
• Other agents and models
• License and use cases
• Data and trust boundaries

Contributing

See CONTRIBUTING.md for development setup, runtime invariants, tests, and dependency-license maintenance. Maintainers tagging a release should follow RELEASING.md. Repository-specific agent guidance lives in AGENTS.md.

License

Mjolnir and its voice worker are licensed under GPL-3.0-only. See LICENSE. Official release archives include the corresponding source offer, dependency reports, and supplemental notices. See License and use cases and Third-party notices.