memoret-cli 0.1.0

Memoret terminal receiver: pairs with the iOS app and ingests end-to-end encrypted voice captures into a local vault directory.

memoret-cli

The terminal receiver for Memoret. Memoret captures voice notes on iOS, transcribes them on-device, and delivers them end-to-end encrypted to a receiver you control. This CLI is one such receiver: it holds the private key, listens on your LAN, and writes decrypted notes and audio into a plain vault directory.

The private key never leaves the machine running this tool. Captures are sealed with libsodium crypto_box_seal on the phone and only ever opened here.

Install

Requires Python 3.11+.

# Recommended: install as an isolated tool (provides the `memoret` command)
uv tool install memoret-cli
#   or
pipx install memoret-cli

Bleeding edge, straight from the monorepo:

uv tool install "git+https://github.com/mysticcoders/memoret.git#subdirectory=cli"

Use

memoret init                 # create config + keypair in ~/.memoret, pick a vault dir
memoret pair                 # print the pairing QR / JSON to scan from the iOS app
memoret serve                # run the receiver with a TUI (press p for the pairing QR)
memoret serve --headless     # run without the TUI, logging to stdout (good for servers)

Config lives in ~/.memoret/config.json (created 0600); the LAN receiver advertises over Bonjour (_memoret._tcp) on port 41831 by default.

Security

• Payloads are end-to-end encrypted; the LAN transport is plaintext HTTP by design because the content is already sealed to the receiver's public key.
• The receiver authenticates uploads with a bearer token established at pairing.
• See the protocol docs at https://developer.memoret.app.

MIT licensed. Part of the mysticcoders/memoret monorepo.