// agent setup / codex

Set up mAgent for Codex.

mAgent launches Codex CLI per project with session resume (`codex resume`), and Codex's `notify` hook feeds the same fleet-state store Claude Code uses.

What you get

  • Every project opens in its own terminal with Codex already running and tiled across your monitors
  • Sessions resume automatically on relaunch
  • Live state (working / needs-input / done / error) in `magent watch`, `magent status --json`, and `magent attention`

Install the CLI

Pick one.

pip
pip install magent-multi-ai-agents-manager
uv
uv tool install magent-multi-ai-agents-manager
from source
git clone https://github.com/DevinoSolutions/magent-multi-ai-agents-manager.git
cd magent-multi-ai-agents-manager
pip install -e .

Install the CLI

Install the magent CLI. No project changes needed -- it is a standalone tool.

pip install magent-multi-ai-agents-manager

Scan projects and write a config

On first run, magent scans your Claude Code, Codex, and VS Code history, finds recent projects, and writes `magent.config.json`. Run `magent --init` any time to rescan.

magent

Wire the Codex notify hook

Run `magent hooks install`. Besides wiring Claude Code, it prints a `notify = [...]` line resolved to this machine's absolute `magent-state-hook` path -- copy that exact printed line into `~/.codex/config.toml` under the `notify` key (the path is machine-specific, so it cannot be hardcoded here). Restart any already-open Codex sessions afterward.

magent hooks install

Verify

Run the environment doctor. It exits 1 on any failure.

magent doctor

Resources

← all agentsraw prompt.md →