Metadata-Version: 2.5
Name: klipper
Version: 0.1.0
Summary: Parse Kindle 'My Clippings.txt' and export to Markdown or JSON.
Author-email: tristan <tristan@example.com>
Requires-Python: >=3.13
Requires-Dist: pydantic>=2.7
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# klipper

Parse Kindle `My Clippings.txt` and export it to Markdown or JSON.

## Install

```sh
uv sync
```

## Usage

```sh
klipper "My Clippings.txt"                          # markdown to stdout
klipper "My Clippings.txt" --format json            # JSON to stdout
klipper "My Clippings.txt" --format md --dedup      # collapse superseded highlights
klipper "My Clippings.txt" -o clippings.md          # write to a file
```

Supported entry kinds: **Highlight**, **Note**, **Bookmark**. Bookmarks are excluded from Markdown output by default. Malformed entries are skipped with a warning on stderr — the run never aborts.

See [`CONTEXT.md`](CONTEXT.md) for domain vocabulary and [`docs/adr/`](docs/adr/) for the architectural decisions.
