work-recall 0.1.0__tar.gz

work_recall-0.1.0/.env.example

@@ -0,0 +1,4 @@
+# Recall reads keys from ~/.recall/config.yaml after `recall config set ...`.
+# These .env values are only used as a fallback (e.g., during development).
+OPENAI_API_KEY=
+COMPOSIO_API_KEY=

work_recall-0.1.0/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+*.egg
+
+# Virtualenvs
+.venv/
+venv/
+env/
+ENV/
+
+# Tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Local secrets
+.env
+.env.local
+
+# Recall local state (should never live in repo)
+.recall/
+*.sqlite
+*.sqlite-journal
+*.sqlite-wal
+*.sqlite-shm

work_recall-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Recall contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

work_recall-0.1.0/Makefile

@@ -0,0 +1,47 @@
+.PHONY: install dev test lint fmt typecheck clean reset seed build publish publish-test
+
+PY ?= python
+
+install:
+	pip install -e .
+
+dev:
+	pip install -e ".[dev]"
+
+test:
+	pytest -q
+
+lint:
+	ruff check recall tests
+
+fmt:
+	ruff format recall tests
+
+typecheck:
+	mypy recall
+
+clean:
+	rm -rf build dist *.egg-info .pytest_cache .ruff_cache .mypy_cache .coverage htmlcov
+
+build:
+	$(PY) -m pip install -q build
+	$(PY) -m build
+
+# Upload to TestPyPI first: https://test.pypi.org/project/work-recall/
+publish-test: build
+	$(PY) -m pip install -q twine
+	twine upload --repository testpypi dist/*
+
+# Production PyPI: https://pypi.org/project/work-recall/
+# Requires: export TWINE_USERNAME=__token__ TWINE_PASSWORD=pypi-...
+publish: build
+	$(PY) -m pip install -q twine
+	@test -n "$$TWINE_USERNAME" || (echo "Set TWINE_USERNAME=__token__" && exit 1)
+	@test -n "$$TWINE_PASSWORD" || (echo "Set TWINE_PASSWORD to your PyPI API token" && exit 1)
+	twine upload dist/*
+
+reset:
+	python scripts/reset_local_db.py
+
+seed:
+	python scripts/dev_seed.py

work_recall-0.1.0/PKG-INFO

@@ -0,0 +1,118 @@
+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
+```

work_recall-0.1.0/README.md

@@ -0,0 +1,81 @@
+# 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
+```

work_recall-0.1.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["hatchling>=1.26.1"]
+build-backend = "hatchling.build"
+
+[project]
+name = "work-recall"
+version = "0.1.0"
+description = "Local-first AI chief of staff for engineers"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{ name = "Recall" }]
+license = "MIT"
+keywords = ["cli", "ai", "productivity", "knowledge-management", "local-first"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Office/Business",
+]
+dependencies = [
+  "typer>=0.12",
+  "rich>=13.7",
+  "pydantic>=2.7",
+  "PyYAML>=6.0",
+  "python-dateutil>=2.9",
+  "APScheduler>=3.10",
+  "platformdirs>=4.2",
+  "openai>=1.30",
+  "sqlite-vec>=0.1.1",
+  "composio-core>=0.5",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0",
+  "pytest-cov>=5.0",
+  "ruff>=0.5",
+  "mypy>=1.10",
+]
+publish = [
+  "build>=1.2",
+  "twine>=5.1",
+]
+
+[project.scripts]
+recall = "recall.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/recall-ai/recall"
+Issues = "https://github.com/recall-ai/recall/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["recall"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "SIM", "RUF"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra -q"

work_recall-0.1.0/recall/__init__.py

@@ -0,0 +1,3 @@
+"""Recall — local-first AI chief of staff for engineers."""
+
+__version__ = "0.1.0"