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 +165 -0
- package/bin/anonli.js +2 -0
- package/dist/index.js +3442 -0
- package/dist/index.js.map +1 -0
- package/package.json +64 -0
package/README.md
ADDED
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
# anon.li CLI
|
|
2
|
+
|
|
3
|
+
> **Encrypted file drops & anonymous email aliases.**
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/anonli)
|
|
6
|
+
[](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