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:

Supported input

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

Actions recognized by parser:

• - mail help -> INLINECODE15
• INLINECODE16 / mail stat -> INLINECODE18
• INLINECODE19 / mail label -> INLINECODE21
• INLINECODE22 -> INLINECODE23
• INLINECODE24 -> INLINECODE25
• 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, INLINECODE33
• Label prefix: label <prefix> or INLINECODE35
• Date filters: after <date>, before <date>, INLINECODE38
• 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).
• INLINECODE45 -> INLINECODE46
• INLINECODE47 -> INLINECODE48
• INLINECODE49 -> INLINECODE50
• INLINECODE51 -> INLINECODE52
• INLINECODE53 -> run in order:

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.