asfml

asfml is a CLI for reading Apache Pony Mail archives from lists.apache.org.

It supports public archives directly and private archives through a manually provided Pony Mail session cookie.

Installation

brew tap xuanwo/tap && brew install asfml   # Homebrew
cargo install asfml                         # Cargo
uv tool install asfml                       # Python / uv
npm install -g asfml                        # npm

Quick Start

Run asfml directly without installing it first:

uvx asfml list [email protected] --limit 5
npx asfml list [email protected] --limit 5

Or use an installed binary:

asfml list [email protected] --limit 5
asfml search [email protected] release --limit 5
asfml read <mid>

Usage

List recent messages:

asfml list [email protected] --limit 5

Search messages:

asfml search [email protected] release --limit 5

Read a message:

asfml read <mid>
asfml read <mid> --parent
asfml read <mid> --root
asfml read <mid> --thread

Authenticate for private archives:

asfml auth set
asfml auth status [email protected]

asfml auth set accepts a raw ponymail cookie value, ponymail=<value>, a full Cookie: header, or Netscape cookies.txt content.

License

Licensed under the Apache License, Version 2.0.