Metadata-Version: 2.4
Name: relay-notes
Version: 0.1.0
Summary: A transport layer for notes between platforms
Project-URL: Homepage, https://github.com/joelkanyi/relay
Project-URL: Repository, https://github.com/joelkanyi/relay
Project-URL: Issues, https://github.com/joelkanyi/relay/issues
Author: Joel Kanyi
License: Apache-2.0
License-File: LICENSE
Keywords: apple-notes,cli,google-keep,markdown,notes,sync
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: gkeepapi>=0.16.0
Requires-Dist: keyring>=25.0.0
Requires-Dist: markdownify>=0.13.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.5.0; extra == 'dev'
Description-Content-Type: text/markdown

# Relay

A transport layer for notes between platforms.

Relay moves notes reliably rather than storing them. It reads from one platform,
normalizes to a portable Markdown form, and writes to another, handling updates
and deduplication so your notes are portable rather than locked in.

## Why

Apple Notes does not integrate with tools like Google Keep, and every notes app
is a silo. Relay is the pipe between them: extract, transform, sync. The core is
boring and deterministic by design, because it is carrying data you cannot
regenerate.

## Example

```sh
relay auth keep                 # one-time: store the Keep token in the Keychain
relay sync --dry-run            # preview every create and update, touch nothing
relay sync --limit 20           # first real write, capped
relay sync                      # incremental sync, all folders
relay export --out ./vault      # Apple Notes -> Markdown files
```

## Status

Phase 1, in progress. The transport engine (model, planner, executor, state) is
in place and tested against in-memory adapters. Apple Notes and Google Keep
adapters are next.
