菜单
Search Gmail and read threads via Charon proxy. Use when the user asks to search email, check Gmail, find threads, or enrich data from email correspondence.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Resolve brain-sync conflict files via AI-prose merge with prototype-aware structural reasoning. Invoke as /nous-resolve <brain-root>.
Use when invoking a nous-provided tool (cmd/<name> — e.g. cmd/gmail for Gmail access) OR when writing a new tool whose Go code calls OAuth-protected APIs. Tool users invoke `cmd/<name>` directly; tool authors need the embedded proxy protocol via `nous instructions`.
Provision the Google refresh token that grounds the OAuth shim's fake against real Google, and run the certification. Use when the conformance test skips ("no Google conformance refresh token"), on ~monthly re-cert, or when porting this to a new OAuth provider (nous#48 Microsoft).
Use proactively for any single-shot LLM call that doesn't need tool use or multi-turn conversation — classification, labelling, summarization, structured extraction, simple rewrites. Routes the work to a LOCAL Ollama model instead of a remote API call. Right answer when the task is bulk/cheap (1k+ items) or doesn't justify a remote-model invocation.
| name | gmail |
| description | Search Gmail and read threads via Charon proxy. Use when the user asks to search email, check Gmail, find threads, or enrich data from email correspondence. |
| compatibility | Go, macOS/Linux, requires charon proxy for auth |
Search Gmail and read full threads. Auth is handled by Charon — no credentials in this tool.
# Search threads for an account
charon run -- go run ./cmd/gmail search --account user@gmail.com "cobalt solar"
# Search with custom result limit
charon run -- go run ./cmd/gmail search --account user@gmail.com --max-results 20 "invoice"
# Read a full thread
charon run -- go run ./cmd/gmail thread --account user@gmail.com <thread_id>
Note: flags must come before the positional argument (Go convention).
JSON to stdout. Structured for programmatic use.
Search returns [{id, subject, sender, date, snippet, message_count}, ...]
Thread returns {id, messages: [{sender, to, date, subject, body}, ...]}
List accounts with charon accounts, then search each:
for acct in $(charon accounts); do
charon run -- go run ./cmd/gmail search --account "$acct" "query"
done
charon auth google user@gmail.comcharon run -- go run ./cmd/gmail search --account user@gmail.com "query"make build then charon run -- cmd/gmail/bin/gmail ...cmd/gmail/main.go — thin subcommand dispatcher, JSON outputlib/gmail/ — Go package with SearchThreads and GetThread, pure HTTP through Charon proxyX-Charon-Account header — no credentials in this repoX-Charon-Account header selects account; Charon injects the bearer token