// faq

Questions, answered.

The same answers as the home page's FAQ section, on their own page so agents and search engines can link straight to it.

What is mAgent?

mAgent is a free, open-source CLI that opens each of your projects in its own terminal window, launches your AI coding agent inside it, and auto-tiles every window into a grid across all of your monitors. One command takes you from an empty desktop to a fully tiled, resumed AI agent workspace.

Which AI coding agents does it support?

Claude Code, OpenAI Codex CLI, and Cursor CLI (cursor-agent) out of the box, alongside editors like VS Code and Cursor. Any tool that runs from your PATH can be launched per project, so mixed fleets — some projects on Claude, some on Codex — work naturally. Live agent state and automatic conversation resume are wired for Claude Code and Codex.

How do I run multiple Claude Code sessions at the same time?

Run magent --go. Each project gets its own terminal window with Claude Code already running, tiled into a grid across your monitors. Sessions resume with claude --continue automatically, and the magent watch table shows the live state of every session — working, needs-input, done, or error — so you always know which window needs you.

Is mAgent free and open source?

Yes. mAgent is open source under the AGPL-3.0 license and free to use. Install it with pip install magent-multi-ai-agents-manager or uv tool install magent-multi-ai-agents-manager; the source lives on GitHub under DevinoSolutions/magent-multi-ai-agents-manager.

Which platforms does it run on?

Windows, macOS, and Linux, with Python 3.10 or newer. A few power features — like psmux persistent sessions and desktop toast notifications — are Windows-only; the capability matrix on this page lists exactly what each platform supports.

Can I monitor and control my agents remotely?

Yes. On Windows, sessions live in psmux, so they survive you walking away — SSH in over Tailscale from any client and re-attach. On every platform you can pair it with Happy for end-to-end-encrypted control of your Claude and Codex sessions from a browser or phone, and upload screenshots from your phone; on Windows an uploaded screenshot drops straight into the focused session.

What do I install, and what do I run?

Install it from PyPI with pip install magent-multi-ai-agents-manager (or uv tool install magent-multi-ai-agents-manager). The command is magent — run magent once to scan your history and write a config, then magent --go to launch and tile every project.

Can an AI agent set mAgent up for me?

Yes. Copy the "Onboard your agent to mAgent" sentence from the pill on the home page or the /agent-setup page and paste it into Claude Code, Codex, Cursor, or any AI coding agent. It fetches /agent-setup/prompt.md and runs the install, config, and (for Claude Code and Codex) lifecycle-hook steps itself — no credentials needed.

Do I need an API key or account to use mAgent?

No. mAgent has no API key, no OAuth flow, and no MCP server — it is a local CLI that launches terminals and agents you already have installed. It never talks to a mAgent-run service.

← back to mAgentonboard your agent →