1 min read
Integration Recipes Index
Portable index for installer recipes that connect external sources to
raw/,state.json, and the compiled wiki.
Open this page when configuring or debugging source integrations such as Gmail, Calendar, meetings, voice, or local tunnels. Workflow routing lives in the corresponding wiki/workflows/*-workflow.md pages.
Recipes
| Recipe | Script / surface | Requires | Durable target |
|---|---|---|---|
| Calendar to brain | sync-calendar.ts |
Google OAuth | raw calendar digest, state.json, relevant wiki updates. |
| Email to brain | sync-email.ts |
Google OAuth | raw email digest, state.json, durable promotions. |
| Meeting sync | sync-meetings.ts |
CIRCLEBACK_TOKEN |
meeting raw capture and promoted pages. |
| Voice to brain | voice-server.ts |
Twilio + OpenAI | voice raw capture and promoted pages. |
| ngrok tunnel | watchdog recipe | ngrok account | local callback/tunnel support. |
Shared integration state lives in ~/.kevin-wiki/integrations.pglite. state.json records successful sync/freshness timestamps; do not fake sync freshness when collection failed.
Agent Use
- Read the workflow page before running an integration.
- Keep OAuth/cursor state out of wiki pages.
- Write raw captures first, then promote durable facts through the ingest pipeline.
- If credentials are missing, report the smallest user action needed.
Timeline
- 2026-07-01 | Refreshed integration recipe index around the current sync/state/freshness model. Source: User request, 2026-07-01
- 2026-05-31 | Agent doc index compiled from recipes/ and AGENTS.md. Source: AGENTS.md, 2026-05-31