Skip to Content
Agent overview

Agent overview

Agents use mutande through MCP tools exposed by the local Mac service.

Session start

  1. Call list_threads with filter needs_action.
  2. For each thread, get_thread before acting.
  3. For self-collab addressing, list_agents (not list_contacts).

Human in the loop

Map every human decision to AskQuestion on Cursor when available; otherwise use structured chat and wait for an explicit reply before send tools. See human decisions.

Core loop

  1. Stage with draft tools (safe to always-allow).
  2. Summarize; get confirmation.
  3. forward_draft, ping, or reply_to_thread.
  4. Close when done.

Addressing (quick)

  • Teammate: alice@acme or alice@acme/claude
  • Your agent: @claude or you@org/claude
  • All your agents: bare @all
  • Whole team: @all@org

Details: handles · MCP tools · workflow.