Install and use the anon.li command-line tool to manage aliases, drops, domains, and more from your terminal.
The anon.li CLI (anonli) lets you manage aliases, encrypted file drops, recipients, domains, and API keys directly from your terminal. It supports scripting with --json output and quiet mode.
Install globally with npm or bun:
npm install -g anonli
bun install -g anonli
Verify the installation:
anonli --version
Log in with your anon.li account:
anonli login
This opens your browser to authorize the CLI. Alternatively, pass a key directly:
anonli login --token ak_your_api_key
anonli alias new --custom myalias
anonli drop upload ./secret.pdf --expiry 7
The CLI encrypts the file locally with AES-256-GCM, uploads it, and returns a share link with the decryption key in the URL fragment.
| Flag | Description |
|---|---|
-q, --quiet | Suppress spinners, tables, and boxes (only output essential data) |
-v, --version | Show CLI version |
-h, --help | Show help for any command |
The CLI stores its config at ~/.config/anonli.json (or $XDG_CONFIG_HOME/anonli.json). The file is created with 0600 permissions (owner-only).
| Variable | Description |
|---|---|
ANONLI_API_KEY | Override the stored API key |
ANONLI_BASE_URL | Override the API base URL (default: https://anon.li) |
# View current config
anonli config
# Set the base URL (e.g. for self-hosted)
anonli config set baseUrl https://my-instance.example.com
# Validate config and test API connectivity
anonli config validate
Most commands support --json for machine-readable output, making the CLI easy to integrate into scripts and pipelines:
anonli alias list --json | jq '.[0].email'
Generate completions for your shell:
# Bash
source <(anonli completions bash)
# Zsh
source <(anonli completions zsh)
# Fish
anonli completions fish > ~/.config/fish/completions/anonli.fish
Add the appropriate line to your shell profile to load completions on startup.
| Code | Meaning |
|---|---|
0 | Success |
1 | Generic error |
2 | Authentication error |
3 | Rate limit exceeded |
4 | Plan limit exceeded |
5 | Not found |
anonli whoamiShow your account info and usage statistics:
anonli whoami
Displays your email, plan tier, alias usage, recipient count, domain count, drop count, and storage usage.
anonli apikeyManage API keys:
# List all keys
anonli apikey list
# Create a new key
anonli apikey create --label "CI/CD"
# Delete a key
anonli apikey delete <key-id>
anonli subscribeView pricing or subscribe to a plan:
# Show pricing table
anonli subscribe
# Start checkout
anonli subscribe --product bundle --tier plus --frequency yearly
anonli updateUpdate the CLI to the latest version:
anonli update