\n\nMjolnir (`mj`) is a full-featured frontend ([ACP client](https://agentclientprotocol.com/get-started/introduction))\nfor **Codex and Claude**. It gives\nboth agents the same terminal workflow, team configuration, review pipeline,\nand remote-control surface, without taking them out of the harness they were trained to use.\n\n## Features\n\n- **Codex and Claude teams:** use either agent in its native harness for coding and review, or split\n the roles between them without changing tools or workflows.\n- **[Integrated adversarial review](https://blog.brokk.ai/mjolnir-automated-cross-vendor-adversarial-review/):**\n automatically challenge changes\n with an independent, cross-provider reviewer with access to [specialized static analysis tooling](https://slopcop.brokk.ai/).\n- **[Remote control]:** run the workspace and control plane on your machine while\n driving the session from another browser or device.\n- **Parallel subagents:** delegate to as many as 16 write-capable agents in\n fresh sessions, with live progress and completed reports returned to the\n primary agent.\n- **Mid-turn steering:** queue a correction while a supported agent is working,\n then use Cancel to apply the oldest queued correction to the running turn.\n- **Worktree sessions:** start work in a linked Git worktree and keep agent\n changes separate from the current checkout, whichever coder you choose.\n- **Shared project knowledge:** carry verified discoveries across Claude and\n Codex sessions through one local, inspectable memory interface synchronized\n into each provider's native memory files.\n- **Local voice input:** dictate prompts on macOS, Linux, and Windows with\n cross-platform, on-device speech recognition.\n\n### Web interface\n\n\n\n## Four teams, one shortcut\n\nChoose one of four teams during onboarding, from `/mjconfig`, or with\n**Shift+Tab** in a session:\n\n- **Codex**\n- **Claude**\n- **Codex coder + Claude reviewer**\n- **Claude coder + Codex reviewer**\n\nThe coder owns the primary session. The reviewer backs the independent review\npass that challenges changed turns, plus the default subagent pool. Switching\nteams keeps Mjolnir's terminal, permissions, sessions, tools, and remote\nworkflow unchanged.\n\nMjolnir itself, its remote-control server, transcripts, and workspace tools run\non infrastructure you control. Model requests still use the selected provider\nunder its terms and data boundaries.\n\n## Shared project knowledge\n\nClaude and Codex should not have to rediscover the same build requirement,\narchitecture constraint, or debugging conclusion in separate sessions.\nMjolnir gives both agents one local project-knowledge layer and synchronizes it\ninto their native memory files before sessions start.\n\nAgents can save verified discoveries as they work, or you can manage them\ndirectly:\n\n```bash\nmj memory list\nmj memory add \"Release builds must run through Nix\"\nmj memory add --global \"Prefer concise commit messages\"\nmj memory forget m7\n```\n\nUse `/memory` for the same workflow inside an interactive session. Knowledge\ncan be project-scoped or global, remains readable in Mjolnir's local\n`memories.json`, and is synchronized into provider-native memory rather than\nbeing added to a user prompt.\n\nMjolnir imports Claude Code's native project `MEMORY.md` into its shared store,\nthen writes a managed section to Claude and Codex native memory files. This\nlets a discovery made in one agent remain useful when you switch teams without\naltering either provider's user messages.\n\nSee [Shared project knowledge](https://mjolnir.brokk.ai/configuration/#shared-project-knowledge)\nfor behavior, controls, and source ownership.\n\n## Requirements\n\nYou need credentials for at least one configured model provider. Mjolnir ships\nwith built-in Codex and Claude ACP routes (and Anvil on Android) and manages\nthe Node.js runtime those routes need: an embedded Node 24 on macOS, Linux,\nand Windows, and Termux's nodejs package on Android (installed via `pkg` when\nnpx is missing). A system Node.js installation is only required when\ninstalling through npm/npx. Provider use may incur cost.\n\nReview the\n[data and trust boundaries](https://mjolnir.brokk.ai/data-boundaries/) before\nconnecting a private repository.\n\n## Install\n\nChoose any of the following methods.\n\n**Release installer:** macOS and Linux on x86-64 or ARM64; Android on ARM64:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/BrokkAi/mjolnir/master/install.sh | bash\n```\n\n**Homebrew:** macOS (Apple Silicon or Intel) and Linux (x86-64 or ARM64 glibc):\n\n```bash\nbrew install brokkai/tap/mjolnir\n```\n\n**npm or npx:** macOS, Linux, Windows, and Android with Node.js 18 or later:\n\n```bash\n# Linux: install the WebKitGTK 4.1 runtime first.\n# Ubuntu/Debian: sudo apt-get install libwebkit2gtk-4.1-0\n# Fedora: sudo dnf install webkit2gtk4.1\nnpm install -g @brokkai/mjolnir\n# Or run without a global install:\nnpx -y @brokkai/mjolnir\n```\n\n**crates.io:** install the terminal client and desktop voice worker with Rust:\n\n```bash\n# Linux: install WebKitGTK 4.1 development files first for `mj app`.\n# Ubuntu/Debian: sudo apt-get install libwebkit2gtk-4.1-dev libasound2-dev\n# Fedora: sudo dnf install webkit2gtk4.1-devel alsa-lib-devel\ncargo install --locked brokk-mjolnir brokk-mj-voice-worker\n```\n\n**Release archive:** download the archive for Linux, macOS, Windows, or\nAndroid from [GitHub Releases](https://github.com/BrokkAi/mjolnir/releases).\n\n**Build from source:**\n\n```bash\ngit clone https://github.com/BrokkAi/mjolnir.git\ncd mjolnir\ncargo build --release\n./target/release/mj --cwd .\n```\n\nDesktop release packages include `mj-voice-worker`; Android packages omit\nvoice support. See the full [installation guide](https://mjolnir.brokk.ai/install/)\nfor platform details, upgrades, checksums, and custom install paths.\n\n## Run\n\nOpen a repository and run:\n\n```bash\nmj\n```\n\nFirst launch discovers available provider credentials and opens setup on the\nteam those credentials support: **Claude coder + Codex reviewer** with both\nproviders signed in, or that provider's own team with one. Press **Shift+Tab**\nto switch teams later, or open the **Team** tab in `/mjconfig`. Team and\nadapter route changes apply to a new session. In an active session, `/model`,\n`/effort`, and their `/mjconfig` entries change the model or reasoning effort\nwithout restarting when the connected ACP agent advertises the corresponding\ncontrol; choices made during a turn apply after that turn completes.\n\n## Try it\n\nThe [10-minute evaluation](https://mjolnir.brokk.ai/evaluate/) uses a\nchecked-in disposable fixture to exercise a delegated subagent change, its\npushed-back report, explicit review, session resume, and headless output without\nrisking a real repository.\n\nFor a quick read-only headless check:\n\n```bash\nmj --print --permission-mode manual \"summarize this repository; do not modify files\"\n```\n\nUse an isolated worktree for an interactive coding session:\n\n```bash\nmj --worktree\n```\n\n## Documentation\n\n- [Teams and adversarial review](https://mjolnir.brokk.ai/teams/)\n- [Install and run](https://mjolnir.brokk.ai/install/)\n- [Start with Codex](https://mjolnir.brokk.ai/codex/)\n- [Start with Claude](https://mjolnir.brokk.ai/claude/)\n- [10-minute evaluation](https://mjolnir.brokk.ai/evaluate/)\n- [Remote control](https://mjolnir.brokk.ai/remote/)\n- [Mid-turn steering and terminal controls](https://mjolnir.brokk.ai/cli-reference/#mid-turn-steering)\n- [Voice dictation](https://mjolnir.brokk.ai/voice/)\n- [Subagents](https://mjolnir.brokk.ai/subagents/)\n- [Shared project knowledge](https://mjolnir.brokk.ai/configuration/#shared-project-knowledge)\n- [Delegation and adversarial review](https://mjolnir.brokk.ai/delegation-review/)\n- [Permissions and workspace scope](https://mjolnir.brokk.ai/permissions/)\n- [Sessions, worktrees, and resume](https://mjolnir.brokk.ai/sessions-worktrees/)\n- [Headless automation](https://mjolnir.brokk.ai/headless/)\n- [Other agents and models](https://mjolnir.brokk.ai/adapters/)\n- [License and use cases](https://mjolnir.brokk.ai/license-use-cases/)\n- [Data and trust boundaries](https://mjolnir.brokk.ai/data-boundaries/)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, runtime\ninvariants, tests, and dependency-license maintenance. Maintainers tagging a\nrelease should follow [RELEASING.md](RELEASING.md). Repository-specific agent\nguidance lives in [AGENTS.md](AGENTS.md).\n\n## License\n\nMjolnir and its voice worker are licensed under `GPL-3.0-only`. See\n[LICENSE](LICENSE). Official release archives include the corresponding source\noffer, dependency reports, and supplemental notices.\nSee [License and use cases](https://mjolnir.brokk.ai/license-use-cases/)\nand [Third-party notices](https://mjolnir.brokk.ai/third-party-notices/).\n","readmeFilename":"README.md"}
![\"Mjolnir](\"docs/public/og.png?v=2\")
\n \n