anonli 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,165 @@
1
+ # anon.li CLI
2
+
3
+ > **Encrypted file drops & anonymous email aliases.**
4
+
5
+ [![npm version](https://img.shields.io/npm/v/anonli?color=blue&style=flat-square)](https://www.npmjs.com/package/anonli)
6
+ [![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg?style=flat-square)](LICENSE)
7
+
8
+ The official CLI for [anon.li](https://anon.li). Share files with end-to-end encryption and manage anonymous email aliases directly from your terminal.
9
+
10
+ ## Features
11
+
12
+ - **End-to-End Encryption**: Files are encrypted on your machine before upload. We never see your data.
13
+ - **Anonymous File Drops**: Create expiring, password-protected file drops.
14
+ - **Email Aliases**: Generate and manage anonymous email aliases to protect your identity.
15
+ - **Custom Domains**: Use your own domains for email aliases.
16
+ - **Disposable & Permanent**: Choose between temporary or permanent aliases.
17
+
18
+ ## Installation
19
+
20
+ ### Automated Install (Linux & macOS, Windows)
21
+
22
+ The quickest way to get started is with our installer script:
23
+
24
+ ```bash
25
+ curl -fsSL https://anon.li/cli/install.sh | bash
26
+ ```
27
+ Or Windows:
28
+ ```bash
29
+ irm https://anon.li/cli/install.ps1 | iex
30
+ ```
31
+
32
+ ### via Package Manager
33
+
34
+ If you have Node.js (18+) installed, you can install via npm, bun, or yarn:
35
+
36
+ ```bash
37
+ # npm
38
+ npm install -g anonli
39
+
40
+ # bun
41
+ bun add -g anonli
42
+
43
+ # yarn
44
+ yarn global add anonli
45
+ ```
46
+
47
+ ## Getting Started
48
+
49
+ Once installed, authenticate with your anon.li account:
50
+
51
+ ```bash
52
+ anonli login
53
+ ```
54
+
55
+ 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.
56
+
57
+ ## Usage
58
+
59
+ ### Encrypted File Drops
60
+
61
+ Share files securely. All encryption happens locally.
62
+
63
+ #### Upload a File or Directory
64
+
65
+ ```bash
66
+ anonli drop upload ./secret-documents
67
+ ```
68
+
69
+ **Options:**
70
+ - `-t, --title <text>`: Set a title for the drop.
71
+ - `-m, --message <text>`: Add an encrypted message.
72
+ - `-e, --expiry <days>`: Set expiration time (default: 1 day).
73
+ - `-n, --max-downloads <n>`: Limit the number of downloads.
74
+ - `-p, --password <pass>`: Password-protect the drop (requires specific plan).
75
+ - `--notify`: Get an email notification when files are downloaded.
76
+ - `--hide-branding`: Remove anon.li branding from the download page.
77
+
78
+ Example:
79
+ ```bash
80
+ anonli drop upload ./report.pdf --expiry 7 --password "hunter2" --notify
81
+ ```
82
+
83
+ #### List Your Drops
84
+
85
+ View your active file drops:
86
+
87
+ ```bash
88
+ anonli drop list
89
+ ```
90
+
91
+ #### Download a Drop
92
+
93
+ Download files from a drop using its ID (and password/key if required):
94
+
95
+ ```bash
96
+ anonli drop download <drop-id>
97
+ ```
98
+
99
+ #### Delete a Drop
100
+
101
+ Permanently remove a drop:
102
+
103
+ ```bash
104
+ anonli drop delete <drop-id>
105
+ ```
106
+
107
+ ---
108
+
109
+ ### Email Aliases
110
+
111
+ Protect your real email address with aliases.
112
+
113
+ #### Create a New Alias
114
+
115
+ Generate a random alias:
116
+
117
+ ```bash
118
+ anonli alias new
119
+ # Output: Created alias: h73hz3e@anon.li
120
+ ```
121
+
122
+ Create a custom alias (if supported by your plan):
123
+
124
+ ```bash
125
+ anonli alias new --custom my-alias --domain anon.li
126
+ ```
127
+
128
+ **Options:**
129
+ - `--label <text>`: Add a description/label to remember what this alias is for.
130
+ - `--recipient <id>`: Forward emails to a specific recipient ID.
131
+
132
+ #### List Aliases
133
+
134
+ See all your aliases:
135
+
136
+ ```bash
137
+ anonli alias list
138
+ ```
139
+
140
+ #### Toggle an Alias
141
+
142
+ Enable or disable an alias:
143
+
144
+ ```bash
145
+ anonli alias toggle <alias-email>
146
+ ```
147
+
148
+ ---
149
+
150
+ ### Other Commands
151
+
152
+ - **`anonli whoami`**: Check current login status.
153
+ - **`anonli domain list`**: Manage custom domains.
154
+ - **`anonli config`**: View current CLI configuration.
155
+ - **`anonli update`**: Update the CLI to the latest version.
156
+
157
+ ## Configuration
158
+
159
+ The CLI stores configuration in `~/.config/anonli.json` (or `$XDG_CONFIG_HOME/anonli.json`).
160
+
161
+ You can override the API key globally by setting the `ANONLI_API_KEY` environment variable.
162
+
163
+ ## License
164
+
165
+ This project is licensed under the AGPL-3.0 License.
package/bin/anonli.js ADDED
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ import "../dist/index.js";