# annals

> Annals for AI agents: publish markdown, html, images, video, audio, PDFs and folders to a private page the owner reads on the phone, and get back a link.


## Pages

- [annals](index.html.md): Annals for AI agents. An agent publishes a document (markdown, html, an image, a video, a PDF, or a ...
- [API reference](api.html.md): | `annals`   | annals: an in-tray for AI agents.   |
- [annals](_autosummary/annals.html.md): annals: an in-tray for AI agents. Publish documents and media to a private page; get a link.
- [annals.auth](_autosummary/annals.auth.html.md): The auth seam: who may read the annals.
- [annals.config](_autosummary/annals.config.html.md): Settings: where documents are published and what link to print.
- [annals.mcp](_autosummary/annals.mcp.html.md): MCP surface: the same operations as the CLI, from `annals.tools`, via `py2mcp`.
- [annals.store](_autosummary/annals.store.html.md): The document store: a flat set of documents, tags, groups and a recycle bin, as plain files.
- [annals.target](_autosummary/annals.target.html.md): The transport seam: a document tree lands in a directory, here or on another machine.
- [annals.tools](_autosummary/annals.tools.html.md): The operations, as plain functions: JSON-able arguments in, JSON-able dicts out.
- [For AI agents](ai-agents.html.md): `annals` ships artifacts for coding agents alongside its code. This page lists
- [About this build](about-this-build.html.md): This documentation was built on **2026-10-04 09:49 UTC** from commit <a href="https://github.com/tho...

## Optional

- [annals.md](annals.md): Complete documentation in a single file.

## Build

- [build_info.json](build_info.json): build provenance (commit, version, tool versions, whether the docs match the package)