Metadata-Version: 2.4
Name: work-recall
Version: 0.1.0
Summary: Local-first AI chief of staff for engineers
Project-URL: Homepage, https://github.com/recall-ai/recall
Project-URL: Issues, https://github.com/recall-ai/recall/issues
Author: Recall
License-Expression: MIT
License-File: LICENSE
Keywords: ai,cli,knowledge-management,local-first,productivity
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Requires-Python: >=3.11
Requires-Dist: apscheduler>=3.10
Requires-Dist: composio-core>=0.5
Requires-Dist: openai>=1.30
Requires-Dist: platformdirs>=4.2
Requires-Dist: pydantic>=2.7
Requires-Dist: python-dateutil>=2.9
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.7
Requires-Dist: sqlite-vec>=0.1.1
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: publish
Requires-Dist: build>=1.2; extra == 'publish'
Requires-Dist: twine>=5.1; extra == 'publish'
Description-Content-Type: text/markdown

# 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

```bash
pip install work-recall
```

## Quick start

```bash
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|status|run}` | Local scheduler.                        |

## 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

```bash
make dev
make test
recall sync --sample
```
