███╗ ███╗ ██████╗ █████╗ ██████╗ ███████╗███╗ ██╗████████╗ ████╗ ████║██╔═══██╗ ██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝ ██╔████╔██║██║ ██║█████╗███████║██║ ███╗█████╗ ██╔██╗ ██║ ██║ ██║╚██╔╝██║██║▄▄ ██║╚════╝██╔══██║██║ ██║██╔══╝ ██║╚██╗██║ ██║ ██║ ╚═╝ ██║╚██████╔╝ ██║ ██║╚██████╔╝███████╗██║ ╚████║ ██║ ╚═╝ ╚═╝ ╚══▀▀═╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═╝
mq-agent
Terminal-native AI agent orchestrator for the mq ecosystem.
What it is
A controlled terminal workflow for AI agent work — explicit planning, tool routing, verification, memory and safety gates. Every action is traceable. The model never runs unsupervised.
Planner
Decomposes goals into steps using gpt-4o structured output.
Executor
Routes steps through a typed tool registry with dry-run support.
Verifier
Checks each result with gpt-4o-mini before moving on.
Safety
Four modes: read-only → suggest → execute → dangerous.
Quick start
$ uv pip install -e ".[dev,signal]" $ mq-agent doctor # check environment $ mq-agent score . # README + publish score $ mq-agent signal . # repo-signal assessment $ mq-agent audit . # read-only repo audit
Commands
mq-agent doctor # environment check mq-agent score . # instant README + publish score mq-agent repo-summary . # repo overview mq-agent tools # list registered tools mq-agent audit . # repo audit mq-agent signal . # repo-signal assessment + AI plan mq-agent release-check # validate release readiness mq-agent fix-ci # diagnose CI failures mq-agent mcp status # check mq-mcp reachability mq-agent mcp tools # list MCP tools with safety classes mq-agent run-tool <tool> # run MCP tool through safety gates mq-agent tui # Textual dashboard