ClawInboxRAG (Community Skill)

Parse and execute mail ... commands for a local mailbox retrieval backend.

What this skill does

• Parses chat commands with scripts/parse_mail.py.
• Routes allowed actions to scripts/run_cli.sh.
• Keeps output concise and citation-friendly.
• Enforces safety constraints (read-only posture, limited command surface, bounded result counts).

Prerequisites

• Local backend checkout.
• Working Python environment and uv runner.
• Gmail OAuth read-only scope.
• Environment variables:
• GMAIL_RAG_REPO (required)
• GMAIL_RAG_UV_BIN (optional, default uv)
• MAIL_DEFAULT_MODE (hybrid default)
• MAIL_DEFAULT_LIMIT (5 default)
• MAIL_MAX_LIMIT (25 default)

Supported input

Trigger: input starts with mail (case-insensitive).

Actions recognized by parser:

• mail help -> help
• mail status / mail stat -> status
• mail labels / mail label -> labels
• mail sync -> sync
• mail recents [max|top|limit N] -> recents
• everything else -> search (if non-empty query remains)

Search options recognized by parser:

• Mode: keyword, semantic, hybrid (plus localized aliases in parser)
• Limit: max N, top N, limit N, limite N
• Label prefix: label or tag
• Date filters: after , before , between and
• Summary flag: resume (also résume, résumé, summary)

Command mapping

Use scripts/run_cli.sh for execution.

• help -> return usage guidance (no CLI call required).
• search -> search [--keyword|--semantic|--hybrid] --limit N [--label-prefix X] [--after ISO] [--before ISO]
• recents -> recents --limit N
• status -> status
• labels -> labels
• sync -> run in order:

1. ingest-primary --limit 50
2. embed --limit 200
3. refresh-labels

Safety constraints

• Read-only Gmail posture.
• No credential/token disclosure.
• No full raw body dumping by default.
• Clamp numeric limits to configured max.
• Validate date parsing before CLI options.
• Use safe argument passing; do not interpolate untrusted shell strings.