GitHub - forketyfork/marx: Multi-Agent Review eXperience: AI review with multiple agents for GitHub PRs

Build status MIT License Python

Marx spins up multiple AI agents in Docker containers, each reviewing your PR independently. It merges their findings, removes duplicates, and gives you a pending GitHub review you can edit before submitting.

Screenshots

CLI summary CLI issues

Features

  • Parallel multi-agent reviews with automatic deduplication
  • YOLO-mode agents run in Docker with review tools and PR context
  • Create a pending GitHub review from merged issues (edit before submit)
  • Structured review outputs with a merged summary
  • Interactive PR selection (excludes your own PRs and PRs assigned to you)
  • Works with local CLI configs or API keys (config dirs are mounted into containers)
  • JSON output for automation via --json-output

Prerequisites

  • git
  • gh (authenticated)
  • docker

Install

Need Nix or a source install? See Installation.

Configure

Create ~/.marx with your GitHub token and any agent keys you want to use. The GitHub token must be a classic PAT with the repo scope (details):

cat > ~/.marx <<'MARX'
GITHUB_TOKEN=ghp_your_token_here
ANTHROPIC_API_KEY=your_claude_key
OPENAI_API_KEY=your_openai_key
GEMINI_API_KEY=your_gemini_key
MARX

If you already use the agent CLIs locally, Marx copies ~/.claude, ~/.codex, and ~/.gemini into the containers so those configs work there too. API keys are optional. See Configuration for details.

Use

# Interactive PR selection
marx

# Review a specific PR with all agents
marx --pr 123 --agents claude,codex,gemini

# Machine-readable output
marx --pr 123 --json-output

Docs