@dropthis/cli 0.4.0 → 0.5.0

package/README.md

@@ -14,7 +14,7 @@ Requires Node.js >= 20.
 
 ```bash
 dropthis login
-dropthis publish index.html
+dropthis ./index.html         # publish is the default command
 ```
 
 ## Authentication
@@ -47,6 +47,8 @@ Credentials resolve in this order:
 2. `DROPTHIS_API_KEY` environment variable
 3. Stored credential from `dropthis login`
 
+If you run `dropthis publish` without credentials in an interactive terminal, the CLI prompts you to log in inline — no separate `dropthis login` step needed. Disable with `--no-interactive`.
+
 ```bash
 dropthis whoami        # Check current auth status
 dropthis logout        # Remove stored credentials
@@ -55,21 +57,29 @@ dropthis logout --revoke  # Remove and revoke the key on the server
 
 ## Publish
 
+`publish` is the default command — you can omit it and pass files directly:
+
+```bash
+# These are equivalent:
+dropthis ./report.html
+dropthis publish ./report.html
+```
+
 ```bash
 # HTML file
-dropthis publish report.html
+dropthis ./report.html
 
 # Directory (static site)
-dropthis publish ./dist
+dropthis ./dist
 
 # Stdin
 echo "<h1>Hello</h1>" | dropthis publish - --content-type text/html --path index.html
 
 # Multiple files bundled into one drop
-dropthis publish index.html styles.css app.js
+dropthis index.html styles.css app.js
 
 # Print only the URL (recommended for agents)
-dropthis publish ./dist --url
+dropthis ./dist --url
 ```
 
 ### Publish options
@@ -90,9 +100,7 @@ All publish flags:
 | `--title <title>` | Drop title |
 | `--visibility <public\|unlisted>` | Drop visibility |
 | `--password <password>` | Set password protection |
-| `--no-password` | Clear password |
 | `--noindex` | Prevent search indexing |
-| `--index` | Allow indexing |
 | `--entry <path>` | Entry file for directories |
 | `--content-type <mime>` | MIME type (required for stdin) |
 | `--path <path>` | Filename (required for stdin) |
@@ -113,35 +121,39 @@ These flags are inherited by all commands:
 |------|-------------|
 | `--api-key <key>` | Override API key for this invocation |
 | `--api-url <url>` | Override API base URL |
+| `--json` | Force JSON output |
 | `-q, --quiet` | Suppress status output and imply JSON |
+| `--no-interactive` | Disable interactive prompts (inline auth, confirmations) |
 
 ## Update
 
+Update an existing drop's content, metadata, or both via `drops update`:
+
 ```bash
 # Replace content
-dropthis update drop_abc123 ./dist-v2
+dropthis drops update drop_abc123 ./dist-v2
 
 # Update metadata only
-dropthis update drop_abc123 --title "New title"
+dropthis drops update drop_abc123 --title "New title"
 
 # Optimistic concurrency
-dropthis update drop_abc123 ./dist-v2 --if-revision 1
+dropthis drops update drop_abc123 ./dist-v2 --if-revision 1
 
 # Change vanity slug
-dropthis update drop_abc123 --slug new-slug
+dropthis drops update drop_abc123 --slug new-slug
 ```
 
-The `update` command supports all publish flags plus `--slug` and `--if-revision`.
+`drops update` supports all publish flags plus `--slug` and `--if-revision`.
 
 ## Commands
 
 ```bash
-dropthis publish [input...]            # Publish content, get a URL
-dropthis update <drop-id> [input]      # Update an existing drop
+dropthis [input...]                    # Publish content (default command)
+dropthis publish [input...]            # Same as above, explicit form
 
 dropthis drops list                    # List your drops
 dropthis drops get <drop-id>           # Get drop details
-dropthis drops update <drop-id>        # Update drop metadata
+dropthis drops update <drop-id> [input] # Update content or metadata
 dropthis drops delete <drop-id>        # Delete a drop
 
 dropthis login                         # Authenticate with email OTP
@@ -166,10 +178,15 @@ dropthis commands                      # Machine-readable command metadata
 
 The CLI is designed for non-interactive use. In non-TTY environments (pipes, CI, agents), output defaults to JSON automatically.
 
-**Environment variable auth (recommended for CI):**
+**Environment variables:**
+
+```bash
+export DROPTHIS_API_KEY=sk_live_...    # API key (same as --api-key)
+export DROPTHIS_API_URL=https://...    # Override API base URL (same as --api-url)
+export DROPTHIS_NON_INTERACTIVE=1      # Disable interactive prompts (same as --no-interactive)
+```
 
 ```bash
-export DROPTHIS_API_KEY=sk_live_...
 dropthis publish ./dist --url
 ```
 
@@ -178,6 +195,7 @@ dropthis publish ./dist --url
 - Use `--url` to get only the published URL (cleanest for agents)
 - Use `--json` for the full structured response
 - Use `--yes` for destructive commands (`drops delete`, `api-keys delete`)
+- Use `--no-interactive` to disable inline auth prompts
 - All errors write to stderr as JSON with a `next_action` field
 
 **Exit codes:**
@@ -211,18 +229,18 @@ Run diagnostics to verify CLI health:
 dropthis doctor
 ```
 
-Reports CLI version, auth source (`env`, `flag`, `stored`, or `missing`), and credential storage backend (`keyring`, `file`, or `none`).
+Reports CLI version, auth source (`env`, `flag`, `storage`, or `missing`), and credential storage backend (`secure`, `insecure`, or `none`).
 
 ```json
-{"ok":true,"version":"0.2.4","auth":{"source":"env"},"storage":{"backend":"keyring"}}
+{"ok":true,"version":"0.4.1","auth":{"source":"env"},"storage":{"backend":"secure"}}
 ```
 
 ## Agent skills
 
-This CLI ships with an [agent skill](https://skills.sh) that teaches AI coding agents (Cursor, Claude Code, Windsurf, etc.) how to use the dropthis CLI effectively, including non-interactive flags, output formats, and common pitfalls.
+For AI coding agents (Cursor, Claude Code, Windsurf, etc.), install the [dropthis-skills](https://github.com/dropthis-dev/dropthis-skills) package:
 
 ```bash
-npx skills add dropthis-dev/dropthis-cli
+npx skills add dropthis-dev/dropthis-skills
 ```
 
 ## Links