// Configure Gmail Browser with /connect and use Gmail ConnectorAct actions through the global Puffer browser profile.
| name | gmail-browser |
| description | Configure Gmail Browser with /connect and use Gmail ConnectorAct actions through the global Puffer browser profile. |
| allowed-tools | ["Bash"] |
| argument-hint | [Gmail Browser task] |
| arguments | target |
| user-invocable | true |
| disable-model-invocation | false |
Use /connect gmail-browser <connection> when the user needs Gmail Browser
setup or auth repair. The flow opens Gmail in the global Puffer browser profile,
lets the user sign in, discovers logged-in Gmail accounts, and saves the
accounts selected for monitoring.
Target: $target
Configuration command:
/connect gmail-browser <connection>
Use ConnectorAct for configured Gmail Browser connections instead of opening
a separate browser session. Gmail Browser uses email-style action names:
list_emails for recent messages with optional mailbox, category,
label, query, from, subject, keywords, unread, and limit.list_inbox, list_category, and search_emails as read/search variants.mark_read, draft_reply, draft_forward, send_email, and delete for
message state changes, drafts, sends, and deletion.requestuserbrowseraction only when the connector needs the user to complete
sign-in or approval in the global Puffer browser profile.Do not use read_messages for Gmail Browser. That action name belongs to chat
connectors such as Slack and Lark. For Gmail Browser reads, use list_emails
or search_emails.
Connector action examples:
{"connector_slug":"gmail-browser","connection_slug":"gmail-browser","action":"list_emails","input":{"account":"cs@agentenv.io","limit":20,"unread":true}}
{"connector_slug":"gmail-browser","connection_slug":"gmail-browser","action":"search_emails","input":{"account":"cs@agentenv.io","query":"from:alice newer:7d","limit":20}}
{"connector_slug":"gmail-browser","connection_slug":"gmail-browser","action":"draft_reply","input":{"account":"cs@agentenv.io","thread_id":"thread-a:r123","body":"Thanks, looking now."}}
When a connection monitors multiple accounts, include account with the Gmail
address to select the mailbox. If omitted, Gmail Browser uses the first
configured account for that connection.
Consolidate durable project memory from the current conversation and identify traces that may deserve genskill.
Generate a reusable skill from the current conversation history using a GEPA-style multi-candidate loop with LLM-as-judge Pareto selection.
Configure Google Calendar Browser with /connect and use Calendar ConnectorAct actions through the global Puffer browser profile.
Recipe for rendering a code review as a Canvas — compose findings with evidence and actions into a scannable page instead of a long text answer.
Guide for implementing or updating a Puffer connector. Use when Codex needs to add a new connector template, subscriber stream, internal connector tool, ConnectorAct action, /connect auth flow, workflow subscription support, or a puffer-connector-* Rust crate in the Puffer repo.
Guide for developing Puffer's computer-use integration and vendored CUA driver. Use when Codex works on vendor/cua-driver, scripts/build-cua-driver.sh, scripts/cua-computer-sandbox.sh, docker/cua-driver-native, CUA MCP manifests, screenshots/image tool-result handling, or specs/puffer-core/118.md.