Accounter

Accounter is a CLI tool that scans IMAP mail folders, extracts registrable domains from message headers, and writes a sorted unique list to a JSON file.

Requirements

• Node.js 20+
• An email account with IMAP access

Setup

npm install
npm run build

Usage

npm run start

Follow the prompts for email credentials, IMAP provider, and folders to scan. Use an app password when your provider requires one.

Results are written to YYYY-MM-DD_output.json.

Credentials are used only for the IMAP session and are not written to the output file. Treat generated JSON files as sensitive metadata.

Development

• npm run dev — watch TypeScript and restart the CLI on changes
• npm test — run tests
• npm run lint — run Biome checks

License

See LICENSE.