Mana-Agent

Repository intelligence and safe multi-agent coding automation.

Mana-Agent is a Python CLI and optional dashboard for understanding, operating, and safely changing software repositories.

Features

• Repository analysis and evidence-backed chat
• Multi-agent planning, coding, review, and verification
• Safe Git, document, browser, and computer-control tools
• Reusable external API integrations with validated requests, approvals, and SSRF protection
• Adaptive model routing and repository-scoped memory
• Visible context/cost budgets, lazy tool schemas, and lossless-backed result compression
• Automations, Teach Mode, Live Canvas, and media generation
• Gmail, Telegram, ACP, A2A, MCP, SSH, and reverse-worker integrations
• CLI, dashboard, and reusable analysis artifacts
• Durable execution supervision with leases, checkpoints, safe recovery, cancellation, result escrow, and verified completion

Install

pipx

pipx install git+https://github.com/manaplatform/mana-agent.git

From source

git clone https://github.com/manaplatform/mana-agent.git
cd mana-agent

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .

Install all optional features:

python -m pip install -e ".[full]"

Quick start

mana-agent --configure
cd /path/to/project
mana-agent

Useful commands:

mana-agent doctor
mana-agent chat --root-dir .
mana-agent dashboard --root-dir .
mana-agent git -- status
mana-agent context report --since 7d
mana-agent tasks list --incomplete
mana-agent tasks status <task-id>
# `mana-agent runs ...` is the visible root-help alias for the same commands.

Inside chat:

/analyze
/tasks
/models
/route explain

How it works

Each user message is stored as an independent durable chat turn. A completed task therefore does not close its conversation: later messages are classified as independent work, a linked follow-up, a safe retry/resume, a status request, or ordinary conversation. Re-delivery is idempotent only for the same client message ID; verified task artifacts remain immutable inputs to follow-up work.

Request → Router → Planner → Taskboard → Execution Supervisor → Tools → Verifier → Verified Result

Repository changes run through constrained tools, isolated worktrees, permission gates, and verification before being returned as merge candidates.

Optional capabilities

python -m pip install -e ".[dashboard]"
python -m pip install -e ".[automations]"
python -m pip install -e ".[observability]"
python -m pip install -e ".[protocols]"

Browser support:

python -m playwright install chromium

Configuration

Run:

mana-agent --configure

Mana-Agent stores configuration under:

~/.mana/config.toml
~/.mana/secrets.toml

Credentials remain separate from normal settings.

Documentation

See the docs/ directory for installation, architecture, commands, connectors, resilient execution, API Manager, automation, Teach Mode, media generation, workers, protocols, and development guides.

Development

python -m pip install -e ".[full]"
python -m pip install pytest ruff mypy

pytest -q
ruff check src tests
mypy src tests

License

Released under the MIT License.