work-recall 0.1.0

Local-first AI chief of staff for engineers

Recall

Local-first AI chief of staff for engineers.

Recall connects your engineering tools (Slack, Gmail, Calendar, Linear), syncs them into a local SQLite database, and builds intelligence on top of your work — meetings, blockers, risks, follow-ups, project timelines.

Everything indexed stays on your machine. No cloud DB. No SaaS backend.

Install

pip install work-recall

Quick start

recall init
recall config set OPENAI_API_KEY sk-...
recall config set COMPOSIO_API_KEY ...

# Try the sample data (no OAuth needed)
recall sync --sample
recall today
recall risks
recall timeline auth

# Or connect your real accounts
recall connect slack
recall connect gmail
recall connect calendar
recall connect linear
recall sync
recall schedule enable --every 4h
recall schedule run     # foreground; background with `nohup`/launchd/systemd

Commands

Command	Purpose
recall init	Create ~/.recall/, run migrations.
recall doctor	Verify setup.
recall config set KEY VALUE	Manage API keys / settings.
recall connect <source>	OAuth via Composio.
recall sync [--sample]	Incremental sync.
recall today	Today's meetings, blockers, focus items.
recall prep <meeting>	Prep brief for an upcoming meeting.
recall risks	At-risk projects, overdue commitments.
recall followups [--for X]	Open commitments.
recall timeline <project>	Chronological project timeline.
recall standup	Yesterday + today, for stand-up.
`recall schedule {enable	disable

Architecture

Connectors (Composio)
     │
     ▼
Raw events ─▶ Noise filter ─▶ Normalize ─▶ Score ─▶ Route by tier
                                                       │
                            ┌──────────────────────────┼──────────────────────────┐
                            ▼                          ▼                          ▼
                     Entity + graph             Chunks + embeddings          Hot memory
                            └──────────────────────────┴──────────────────────────┘
                                                       ▼
                                           Intelligence (today, risks, timeline…)

Storage lives at ~/.recall/.

Development

make dev
make test
recall sync --sample