a-memo 1.3.1

Lightweight memo CLI tool with SQLite + FTS5

a-memo

A lightweight memo CLI for quick notes, tags, search, review, links, backup, import/export, and share images.

Install

macOS / Linux binary

Download the right archive from the latest release:

• macOS Apple Silicon: memo-macos-arm64.tar.gz
• macOS Intel: memo-macos-x86_64.tar.gz
• Linux x86_64: memo-linux-x86_64.tar.gz

tar -xzf memo-macos-arm64.tar.gz
chmod +x memo
./memo --version

Install it into your PATH:

mkdir -p ~/.local/bin
mv memo ~/.local/bin/memo
memo --help

Add ~/.local/bin to your PATH:

export PATH="$HOME/.local/bin:$PATH"

Windows binary

Download memo-windows-x86_64.zip from the latest release, unzip it, then run:

.\memo.exe --version

uv

uv tool install a-memo

Upgrade:

uv tool upgrade a-memo

pipx

pipx install a-memo

Upgrade:

pipx upgrade a-memo

pip

pip install a-memo

Upgrade:

pip install --upgrade a-memo

Share Images

Generate a vertical PNG share image:

memo image 1
memo image 1 --out share.png

Images use a 600px wide vertical card. Tags, text, timestamp, and memo count are rendered into the PNG directly.

Usage

memo add "read later #idea"
memo list
memo list '#idea'
memo search "later"
memo review
memo review --push
memo link 1 2
memo links 1
memo image 1
memo backup
memo export --out memos.json
memo import memos.json
memo flomo-import export.html

Show all commands:

memo --help
memo <command> --help

Show version:

memo --version

Backup And Migration

Create a backup:

memo backup
memo backup --out ~/Desktop/memo.db

Export portable JSON:

memo export --out memos.json

Import JSON:

memo import memos.json

Replace current data with an export:

memo import memos.json --replace

Reset local data:

memo reset --force

Data Location

memo stores local data under:

~/.memo/

Use memo backup or memo export before moving data between machines.

License

MIT