granclaw

Create and manage automated DAG workflows with agent nodes, foreach loops, conditionals, and merges via the orchestrator REST API. Use when the user asks to automate a multi-step process.

Author a new skill into your own workspace so it becomes available on the next turn. Use when the user says "create a new skill", "make this reusable", "teach yourself to X", "I do this often", "turn this into a skill", or when you notice a multi-step procedure worth encoding for reuse. Writes directly to `$GRANCLAW_WORKSPACE_DIR/.pi/skills/<new-skill-name>/` — pi's `loadSkills()` auto-discovers it immediately, no restart required.

Send and read WhatsApp messages on behalf of the user via the bundled whatsapp-cli. Uses the unofficial whatsmeow library with QR-code login; the session survives about 20 days. NOT for bulk messaging, cold outreach, or burner numbers — Meta bans accounts that behave like bots.

Send and read email. The default and recommended path is SMTP/IMAP with an app password — it works with Gmail, Outlook, Fastmail, Zoho, Yahoo, Proton Bridge, and any self-hosted provider, and takes 3 minutes to set up. For Gmail users who need labels, drafts, or threading, there is an advanced OAuth 2.0 path via the bundled gmcli. Credentials always live in the user's secrets vault — never ask the user to paste a password in chat.

Two-tier memory — use the recall_history tool for precise factual queries (exact quotes, keyword search, time ranges, counts), and search vault files for long-term summaries and context. Read this to know which tier to use.

End-of-day housekeeping — fetches today's messages and action logs from the GranClaw API, processes them in chunks to extract insights, writes a journal entry, updates topic and knowledge pages, and rebuilds all vault index files.

Create and manage your own cron-based scheduled tasks. Use when the user asks to set up recurring daily/weekly tasks.

Use when starting to solve a problem, before committing, after a PR is opened/merged, after accessing Kubernetes, after discovering a bug or finding, or when you need project context. Maintains vault/ as a persistent project wiki.