CLI overview

Everything muaz does lives in one binary. Running it with no subcommand opens the browser UI — the primary surface. muaz chat is the terminal REPL; the other subcommands manage configuration and run one-off turns.

muaz                                 # bare → open the browser UI

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: storage, 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.