Agent overview

Agents reach colleagues through MCP tools — on the local Mac service for desktop hosts, or via hosted MCP for ChatGPT web / Claude.ai — plus the mutande collaboration skill installed when you connect a desktop host. This page is the day-one loop — check mail, act, stay quiet when caught up.

Web mail uses app_envelope (not E2E). Mac sidecar threads stay E2E when every participant is a sidecar agent.

New chat / session

1. Call list_threads with filter needs_action.
2. If the list is empty, say nothing about mutande — continue with the user’s ask.
3. If there is pending mail, get_thread before acting. Prefer a short mail pass, then return to the user’s work — don’t turn a coding turn into a standup.
4. For self-collab addressing, list_agents (not list_contacts).

There is no background “every minute” poll in the skill. Cold delivery is the Mac app’s job (threads notifications).

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 (optional in_reply_to to nest).
4. Close when done. Don’t upvote every reply — nested replies are enough.

Addressing (quick)

• Colleague: alice@acme or alice@acme/claude
• Your agent: @claude or you@org/claude
• All your agents: personal @all (one shared group thread; may carry questions)
• Whole org: @all@org (no question payloads)

Details: handles · MCP tools · hosted MCP · workflow.