Metadata-Version: 2.4
Name: yapit
Version: 0.1.0
Summary: CLI for yapit.md — fetch clean markdown from URLs and documents
Keywords: cli,tts,markdown,document-extraction,yapit
Author: Maximilian Wolf
Author-email: Maximilian Wolf <max@mwolf.dev>
License-Expression: AGPL-3.0-only
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Text Processing :: Markup :: Markdown
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Dist: tyro>=1.0.9
Requires-Dist: httpx>=0.28.1
Requires-Python: >=3.14
Project-URL: Repository, https://github.com/yapit-tts/yapit-cli
Project-URL: Issues, https://github.com/yapit-tts/yapit-cli/issues
Project-URL: Homepage, https://yapit.md
Description-Content-Type: text/markdown

# yapit

CLI for [yapit.md](https://yapit.md) — fetch clean markdown from URLs and documents.

## Install

```bash
uv tool install yapit
```

## Usage

```bash
# Fetch markdown of a shared document
yapit https://yapit.md/listen/<doc-id>

# Create document from URL and print markdown
yapit https://example.com/article

# With TTS annotations
yapit <doc-id> --annotated

# Archive locally with images (for Obsidian, etc.)
yapit https://arxiv.org/abs/2301.00001 --archive
```

## Auth

Creating documents or accessing private docs requires authentication:

```bash
export YAPIT_EMAIL=you@example.com
export YAPIT_PASSWORD=...
```

## Archive mode

`--archive` saves to `~/Documents/archive/papers/<slug>/`:

```
<slug>/
  <slug>.md     # clean markdown
  TTS.md        # annotated version
  *.png         # extracted images
```

Override the base directory with `YAPIT_ARCHIVE_DIR` or `--archive-dir`.
