Metadata-Version: 2.4
Name: memoret-cli
Version: 0.1.1
Summary: Memoret terminal receiver: pairs with the iOS app and ingests end-to-end encrypted voice captures into a local vault directory.
Project-URL: Homepage, https://memoret.app
Project-URL: Documentation, https://developer.memoret.app
Project-URL: Repository, https://github.com/mysticcoders/memoret-cli
Project-URL: Issues, https://github.com/mysticcoders/memoret-cli/issues
Author-email: "Mystic Coders, LLC" <andrew@mysticcoders.com>
License-Expression: MIT
License-File: LICENSE
Keywords: bonjour,end-to-end-encryption,memoret,obsidian,transcription,voice
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Sound/Audio :: Capture/Recording
Classifier: Topic :: Text Processing
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: pynacl>=1.5
Requires-Dist: qrcode>=7.4
Requires-Dist: textual>=0.80
Requires-Dist: zeroconf>=0.132
Description-Content-Type: text/markdown

# memoret-cli

The terminal **receiver** for [Memoret](https://memoret.app). 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+.

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

Bleeding edge, straight from source:

```bash
uv tool install "git+https://github.com/mysticcoders/memoret-cli.git"
```

## Use

```bash
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. Issues and pull requests: [mysticcoders/memoret-cli](https://github.com/mysticcoders/memoret-cli).
