CLI overview

The muaz binary is the primary way to use muaz. Running it with no subcommand starts a chat with the default agent; the other subcommands manage configuration, run one-off turns, and launch the browser UI.

muaz                                 # bare → chat with the default agent

Commands:
  chat       Start an interactive chat session
  run        Run a single non-interactive turn (text or JSON output)
  pipeline   Run or list multi-agent pipelines
  agents     Manage agents
  skills     Manage Agent Skills
  config     View and edit global configuration
  mcp        Manage MCP server registrations
  runtime    Manage the bundled Node/uv runtimes
  doctor     Health check: config, runtimes, MCP reachability
  gateway    Start the web gateway server with a browser-based UI

Common workflows

• Chat with an agent — muaz chat
• One-off scripted turn — muaz run (e.g. git diff | muaz run "review this")
• Run a pipeline — muaz pipeline run
• Create and edit agents — muaz agents
• Manage skills — muaz skills
• Edit global config — muaz config
• Register MCP servers — muaz mcp
• Launch the browser UI — muaz gateway
• Diagnose problems — muaz doctor

For the full list of commands and flags, see the Command reference. For slash commands available inside the REPL, see Slash commands.