// agent setup / claude-code

Set up mAgent for Claude Code.

mAgent launches Claude Code per project with session auto-resume (`claude --continue`), and Claude Code's own lifecycle hooks feed the fleet-state store that `magent watch`, `magent sessions --json`, and `magent attention` all read.

What you get

  • Every project opens in its own terminal with Claude Code already running and tiled across your monitors
  • Sessions auto-resume with `claude --continue` on relaunch
  • Live state (working / needs-input / done / error) in `magent watch`, `magent status --json`, and `magent attention`
  • Windows: `magent terminal install` fixes Ctrl+Backspace and Shift+Enter inside persistent psmux sessions

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 Claude Code lifecycle hooks

Merges the bundled `magent-state-hook` writer into `~/.claude/settings.json` (idempotent -- any existing hooks are preserved). This is what feeds live per-session state to `magent watch`, `magent status`, and `magent attention`; without it those tools show no status for Claude Code sessions. Restart any already-open Claude Code sessions afterward so the new hooks take effect.

magent hooks install

Windows only: fix Ctrl+Backspace and Shift+Enter

Only relevant if persistent psmux sessions are enabled (`settings.psmux: true`). psmux drops key modifiers in transit, so this binds the two keys in Windows Terminal itself so they still work inside a psmux pane. Safe to run unconditionally -- it is a no-op off Windows or without Windows Terminal.

magent terminal install

Verify

Run the environment doctor and confirm the hooks report installed. `magent doctor` exits 1 on any failure.

magent doctor
magent hooks status

Resources

← all agentsraw prompt.md →