anon.li CLI

Encrypted file drops & anonymous email aliases.

The official CLI for anon.li. Share files with end-to-end encryption and manage anonymous email aliases directly from your terminal.

Features

• End-to-End Encryption: Files are encrypted on your machine before upload. We never see your data.
• Anonymous File Drops: Create expiring, password-protected file drops.
• Email Aliases: Generate and manage anonymous email aliases to protect your identity.
• Custom Domains: Use your own domains for email aliases.
• Disposable & Permanent: Choose between temporary or permanent aliases.

Installation

Automated Install (Linux & macOS, Windows)

The quickest way to get started is with our installer script:

curl -fsSL https://anon.li/cli/install.sh | bash

Or Windows:

irm https://anon.li/cli/install.ps1 | iex

via Package Manager

If you have Node.js (18+) installed, you can install via npm, bun, or yarn:

# npm
npm install -g anonli

# bun
bun add -g anonli

# yarn
yarn global add anonli

Getting Started

Once installed, authenticate with your anon.li account:

anonli login

This will open a browser window to authorize the CLI. If you're on a headless server, you can set the ANONLI_API_KEY environment variable instead.

Usage

Encrypted File Drops

Share files securely. All encryption happens locally.

Upload a File or Directory

anonli drop upload ./secret-documents

Options:

• -t, --title <text>: Set a title for the drop.
• -m, --message <text>: Add an encrypted message.
• -e, --expiry <days>: Set expiration time (default: 1 day).
• -n, --max-downloads <n>: Limit the number of downloads.
• -p, --password <pass>: Password-protect the drop (requires specific plan).
• --notify: Get an email notification when files are downloaded.
• --hide-branding: Remove anon.li branding from the download page.

Example:

anonli drop upload ./report.pdf --expiry 7 --password "hunter2" --notify

List Your Drops

View your active file drops:

anonli drop list

Download a Drop

Download files from a drop using its ID (and password/key if required):

anonli drop download <drop-id>

Delete a Drop

Permanently remove a drop:

anonli drop delete <drop-id>

---

Email Aliases

Protect your real email address with aliases.

Create a New Alias

Generate a random alias:

anonli alias new
# Output: Created alias: h73hz3e@anon.li

Create a custom alias (if supported by your plan):

anonli alias new --custom my-alias --domain anon.li

Options:

• --label <text>: Add a description/label to remember what this alias is for.
• --recipient <id>: Forward emails to a specific recipient ID.

List Aliases

See all your aliases:

anonli alias list

Toggle an Alias

Enable or disable an alias:

anonli alias toggle <alias-email>

---

Other Commands

• anonli whoami: Check current login status.
• anonli domain list: Manage custom domains.
• anonli config: View current CLI configuration.
• anonli update: Update the CLI to the latest version.

Configuration

The CLI stores configuration in ~/.config/anonli.json (or $XDG_CONFIG_HOME/anonli.json).

You can override the API key globally by setting the ANONLI_API_KEY environment variable.

License

This project is licensed under the AGPL-3.0 License.