Skip to main content

Automated multi-agent code review tool for GitHub PRs

Project description

MARX - Multi-Agentic Review eXperience

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

uv tool install marx-ai

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

marx_ai-0.3.1.tar.gz (32.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

marx_ai-0.3.1-py3-none-any.whl (30.0 kB view details)

Uploaded Python 3

File details

Details for the file marx_ai-0.3.1.tar.gz.

File metadata

  • Download URL: marx_ai-0.3.1.tar.gz
  • Upload date:
  • Size: 32.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for marx_ai-0.3.1.tar.gz
Algorithm Hash digest
SHA256 5727b58ee3a44b7b6fb81289e61b60b4a21bae606910e8062d15a9f6aaa99110
MD5 6365e6d1f0fd5f8b6080e1d0f5fb9cf9
BLAKE2b-256 23963480602be21cfa305ad62fda5c2b504b5bc19cc670cf74e78c9c75a914c4

See more details on using hashes here.

File details

Details for the file marx_ai-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: marx_ai-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 30.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for marx_ai-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 21ab0bc6e9f17cbd3362edbda624b286e0bdd50bdf8df7c072863722d684993e
MD5 c3ea3f4d001db25c6184c6f9d1baeb30
BLAKE2b-256 c53c8369057695537334d98ffdecfc41134fc18c96faa0ea4e553c07357e6847

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page