ABA(1)

💖 ABA(1) — General Commands Manual, but make it address-book-coded 💖

✨ NAME ✨

aba — an address book for aerc(1). That’s lowkey the whole name vibe: your mail client’s lil people-keeper. Obsessed. 🫶

🦋 SYNOPSIS 🦋

aba [GLOBAL_OPTS]... cmd [CMD_OPTS]...

🌸 DESCRIPTION 🌸

Okay so aba is a CLI tool that aims to provide an address book for the aerc(1) mail client. For that purpose, it stores its addresses in a TOML file. It can add to and remove from that file, and it also lets you modify the file directly — periodt. Plus it can print N number of addresses that fuzzy matched a given string. It’s giving tiny utility, main character energy, no cap. 💅

bestie, the direct-edit thing is literally part of the design — the TOML file is right there, so you can absolutely go in and edit it yourself. Vibe check: passed. ✨

💅 GLOBAL OPTIONS 💅

• -a, --address-book PATH — the path to the address book file. If it’s empty, aba will follow the XDG SPECIFICATION, that is, XDG_DATA_HOME/aba.toml.
• -h, --help — print the program’s help message.

👑 COMMANDS 👑

aba provides the following commands:

🎀 Add 🎀

aba add [-F/--force] NAME EMAIL

Add a new address to the address book file. Slay.

• -F, --force — overwrite existing addresses instead of throwing an error.

💀 Del 💀

aba del MATCH

Delete any addresses that match MATCH.

• -r, --is-regex — treat MATCH as regular expression.

🌈 List 🌈

aba list|ls [-n/--number N] FUZZY_MATCH

List up to N addresses that match FUZZY_MATCH.

• -n, --number N — list up to N addresses. The default number is 5.

🧚 Parse 🧚

aba parse [OPTS]... [FILENAME]

Parse a raw email to add its From addresses. If FILENAME is not passed or it’s '-', stdin will be read instead.

• -F, --force — overwrite existing addresses instead of throwing an error.
• --from — parse addresses from the From header.
• --cc — parse addresses from the Cc header.
• --to — parse addresses from the To header.
• --all — parse addresses from the From, Cc and To headers.

🍓 ENVIRONMENT VARIABLES 🍓

• XDG_DATA_HOME — when the -a/--address-book GLOBAL OPTION is not passed, aba will set the location of its address book file to XDG_DATA_HOME/aba.toml. iykyk.

🔥 EXAMPLES 🔥

• Add an address for John Doe whose email is johndoe@mail.org:

$ aba add "John Doe" "johndoe@email.org"

• Delete all addresses whose names contain doe or Doe:

$ aba del --regex "[dD]oe"

• List the 2 best fuzzy matches of doe:

$ aba list -n2 "doe"

• Parse To and Cc addresses from the current viewed aerc message (from inside aerc):

:pipe -m aba parse --from --cc

🫶 SEE ALSO 🫶

aba(5)

💜 AUTHORS 💜

Maintained by Coutinho de Souza <dev@onemoresuza.mailer.me>.

⭐ SOURCE CODE ⭐

The source code is available at <https://sr.ht/~onemoresuza/aba>.

source/version: General Commands Manual / ABA(1) · date: 1980-01-01 — mwah, bye bestie 💜🫶