domani 0.3.9 → 0.3.10
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 +59 -59
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# domani
|
|
2
2
|
|
|
3
|
-
Domains and email
|
|
3
|
+
Domains and email - for humans and AI agents.
|
|
4
4
|
|
|
5
5
|
Register domains, manage DNS, create mailboxes, send and receive email. From your terminal, your agent, or the web.
|
|
6
6
|
|
|
@@ -11,12 +11,12 @@ Register domains, manage DNS, create mailboxes, send and receive email. From you
|
|
|
11
11
|
|
|
12
12
|
domani gives you one account and multiple ways in:
|
|
13
13
|
|
|
14
|
-
- **[Web](https://domani.run)**
|
|
15
|
-
- **CLI**
|
|
16
|
-
- **[MCP Server](https://domani.run/mcp)**
|
|
17
|
-
- **[OpenClaw](https://openclaw.com)**
|
|
18
|
-
- **[Agent Skill](https://domani.run/SKILL.md)**
|
|
19
|
-
- **[REST API](https://domani.run/docs)**
|
|
14
|
+
- **[Web](https://domani.run)** - Dashboard with a full inbox (compose, reply, threads), DNS editor, domain management
|
|
15
|
+
- **CLI** - This package. Everything the web app does, from your terminal
|
|
16
|
+
- **[MCP Server](https://domani.run/mcp)** - 65 tools for Claude Code, Cursor, Windsurf, and any MCP-compatible agent
|
|
17
|
+
- **[OpenClaw](https://openclaw.com)** - `clawhub install domani`
|
|
18
|
+
- **[Agent Skill](https://domani.run/SKILL.md)** - Step-by-step guide your agent can follow. Install with `npx skills add domani.run`
|
|
19
|
+
- **[REST API](https://domani.run/docs)** - Direct HTTP access to everything
|
|
20
20
|
|
|
21
21
|
All interfaces share the same API key and the same data.
|
|
22
22
|
|
|
@@ -92,78 +92,78 @@ domani schema buy --json
|
|
|
92
92
|
|
|
93
93
|
### Domains
|
|
94
94
|
|
|
95
|
-
```
|
|
96
|
-
domani search <name> [tlds...] Check availability across TLDs (--expand for 30+)
|
|
97
|
-
domani suggest <prompt> AI-powered domain suggestions (--style, --lang, --tlds)
|
|
98
|
-
domani buy <domains...> Purchase one or more domains (card or USDC)
|
|
99
|
-
domani transfer <domain> Transfer from another registrar
|
|
100
|
-
domani renew <domain> Renew a domain (--years 1-10)
|
|
101
|
-
domani import <domain> Import a domain you own elsewhere (DNS monitoring only)
|
|
102
|
-
domani list List your domains
|
|
103
|
-
domani status <domain> Health check (DNS, SSL, email, expiry)
|
|
104
|
-
domani tlds List all TLDs with pricing (--sort, --max-price)
|
|
105
|
-
domani whois <domain> WHOIS/RDAP lookup
|
|
95
|
+
```bash
|
|
96
|
+
domani search <name> [tlds...] # Check availability across TLDs (--expand for 30+)
|
|
97
|
+
domani suggest <prompt> # AI-powered domain suggestions (--style, --lang, --tlds)
|
|
98
|
+
domani buy <domains...> # Purchase one or more domains (card or USDC)
|
|
99
|
+
domani transfer <domain> # Transfer from another registrar
|
|
100
|
+
domani renew <domain> # Renew a domain (--years 1-10)
|
|
101
|
+
domani import <domain> # Import a domain you own elsewhere (DNS monitoring only)
|
|
102
|
+
domani list # List your domains
|
|
103
|
+
domani status <domain> # Health check (DNS, SSL, email, expiry)
|
|
104
|
+
domani tlds # List all TLDs with pricing (--sort, --max-price)
|
|
105
|
+
domani whois <domain> # WHOIS/RDAP lookup
|
|
106
106
|
```
|
|
107
107
|
|
|
108
108
|
### Email
|
|
109
109
|
|
|
110
|
-
```
|
|
111
|
-
domani email list List all mailboxes
|
|
112
|
-
domani email create user@domain Create a mailbox
|
|
113
|
-
domani email delete user@domain Delete a mailbox
|
|
114
|
-
domani email inbox user@domain List messages (--direction in|out)
|
|
115
|
-
domani email send user@domain Send an email (--to, --subject, --body, --cc, --bcc)
|
|
116
|
-
domani email forward user@domain Forward inbound to a personal address (--forward-to)
|
|
117
|
-
domani email webhook user@domain Forward inbound as JSON to your endpoint (--url)
|
|
118
|
-
domani email setup <domain> Auto-configure MX, SPF, DKIM, DMARC
|
|
119
|
-
domani email status <domain> Check email DNS health
|
|
120
|
-
domani email connect <domain> <provider> Connect external provider (Gmail, Fastmail, Proton)
|
|
110
|
+
```bash
|
|
111
|
+
domani email list # List all mailboxes
|
|
112
|
+
domani email create user@domain # Create a mailbox
|
|
113
|
+
domani email delete user@domain # Delete a mailbox
|
|
114
|
+
domani email inbox user@domain # List messages (--direction in|out)
|
|
115
|
+
domani email send user@domain # Send an email (--to, --subject, --body, --cc, --bcc)
|
|
116
|
+
domani email forward user@domain # Forward inbound to a personal address (--forward-to)
|
|
117
|
+
domani email webhook user@domain # Forward inbound as JSON to your endpoint (--url)
|
|
118
|
+
domani email setup <domain> # Auto-configure MX, SPF, DKIM, DMARC
|
|
119
|
+
domani email status <domain> # Check email DNS health
|
|
120
|
+
domani email connect <domain> <provider> # Connect external provider (Gmail, Fastmail, Proton)
|
|
121
121
|
```
|
|
122
122
|
|
|
123
123
|
### DNS
|
|
124
124
|
|
|
125
|
-
```
|
|
126
|
-
domani dns <domain> get List all DNS records
|
|
127
|
-
domani dns <domain> set <type> <name> <value> Add/update a record
|
|
128
|
-
domani dns <domain> delete <type> <name> Remove a record
|
|
129
|
-
domani dns <domain> snapshot Export DNS to file
|
|
130
|
-
domani dns <domain> restore Restore DNS from snapshot
|
|
131
|
-
domani nameservers <domain> Get or set nameservers (--reset for defaults)
|
|
132
|
-
domani connect <domain> <target> Auto-configure DNS for a provider
|
|
125
|
+
```bash
|
|
126
|
+
domani dns <domain> get # List all DNS records
|
|
127
|
+
domani dns <domain> set <type> <name> <value> # Add/update a record
|
|
128
|
+
domani dns <domain> delete <type> <name> # Remove a record
|
|
129
|
+
domani dns <domain> snapshot # Export DNS to file
|
|
130
|
+
domani dns <domain> restore # Restore DNS from snapshot
|
|
131
|
+
domani nameservers <domain> # Get or set nameservers (--reset for defaults)
|
|
132
|
+
domani connect <domain> <target> # Auto-configure DNS for a provider
|
|
133
133
|
```
|
|
134
134
|
|
|
135
135
|
**Supported providers**: Vercel, Netlify, Cloudflare Pages, GitHub Pages, Fly.io, Railway, Render, Google Workspace, Fastmail, Proton Mail.
|
|
136
136
|
|
|
137
137
|
### Settings
|
|
138
138
|
|
|
139
|
-
```
|
|
140
|
-
domani settings <domain> View/update auto-renew, WHOIS privacy, security lock
|
|
141
|
-
domani contact [view|set] Manage WHOIS contact info
|
|
142
|
-
domani parking <domain> Manage parking page (enable/disable/price)
|
|
143
|
-
domani analytics <domain> View parking analytics
|
|
144
|
-
domani auth-code <domain> Get EPP auth code for outbound transfer
|
|
145
|
-
domani transfer-away <domain> Check outbound transfer status
|
|
139
|
+
```bash
|
|
140
|
+
domani settings <domain> # View/update auto-renew, WHOIS privacy, security lock
|
|
141
|
+
domani contact [view|set] # Manage WHOIS contact info
|
|
142
|
+
domani parking <domain> # Manage parking page (enable/disable/price)
|
|
143
|
+
domani analytics <domain> # View parking analytics
|
|
144
|
+
domani auth-code <domain> # Get EPP auth code for outbound transfer
|
|
145
|
+
domani transfer-away <domain> # Check outbound transfer status
|
|
146
146
|
```
|
|
147
147
|
|
|
148
148
|
### Account
|
|
149
149
|
|
|
150
|
-
```
|
|
151
|
-
domani login Log in to domani.run (opens browser)
|
|
152
|
-
domani logout Clear saved credentials
|
|
153
|
-
domani me Show account info
|
|
154
|
-
domani billing Add or update payment method (opens browser)
|
|
155
|
-
domani invoices List payment invoices
|
|
156
|
-
domani token Print your API key
|
|
157
|
-
domani tokens [list|create|revoke] Manage API tokens (scoped, expiring)
|
|
158
|
-
domani webhooks [action] Manage webhook endpoints
|
|
150
|
+
```bash
|
|
151
|
+
domani login # Log in to domani.run (opens browser)
|
|
152
|
+
domani logout # Clear saved credentials
|
|
153
|
+
domani me # Show account info
|
|
154
|
+
domani billing # Add or update payment method (opens browser)
|
|
155
|
+
domani invoices # List payment invoices
|
|
156
|
+
domani token # Print your API key
|
|
157
|
+
domani tokens [list|create|revoke] # Manage API tokens (scoped, expiring)
|
|
158
|
+
domani webhooks [action] # Manage webhook endpoints
|
|
159
159
|
```
|
|
160
160
|
|
|
161
161
|
### Introspection
|
|
162
162
|
|
|
163
|
-
```
|
|
164
|
-
domani schema [command] Show command schemas for AI agent integration
|
|
165
|
-
domani update Update to the latest version
|
|
166
|
-
domani uninstall Remove domani CLI and config
|
|
163
|
+
```bash
|
|
164
|
+
domani schema [command] # Show command schemas for AI agent integration
|
|
165
|
+
domani update # Update to the latest version
|
|
166
|
+
domani uninstall # Remove domani CLI and config
|
|
167
167
|
```
|
|
168
168
|
|
|
169
169
|
## Agent integration
|
|
@@ -188,7 +188,7 @@ domani list | jq '.domains[].domain'
|
|
|
188
188
|
| `payment_required` | `domani billing` | No payment method on file |
|
|
189
189
|
| `contact_required` | `domani contact set` | WHOIS contact info missing |
|
|
190
190
|
| `validation_error` | Read `hint` | Invalid input |
|
|
191
|
-
| `not_found` |
|
|
191
|
+
| `not_found` | - | Domain doesn't exist or not owned |
|
|
192
192
|
| `rate_limited` | Wait `Retry-After` | Too many requests |
|
|
193
193
|
|
|
194
194
|
**Flags**:
|
|
@@ -200,7 +200,7 @@ domani list | jq '.domains[].domain'
|
|
|
200
200
|
| `--dry-run` | Preview mutations without executing |
|
|
201
201
|
| `--yes` | Skip confirmation prompts |
|
|
202
202
|
|
|
203
|
-
**Input hardening**: All inputs are validated against path traversal, control characters, query strings, and double encoding
|
|
203
|
+
**Input hardening**: All inputs are validated against path traversal, control characters, query strings, and double encoding - common agent hallucinations.
|
|
204
204
|
|
|
205
205
|
**Schema introspection**: Run `domani schema <command> --json` to get parameter types, constraints, and enums before constructing a command.
|
|
206
206
|
|