@kinosec/cli 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,105 @@
+# @kinosec/cli
+
+[![npm version](https://img.shields.io/npm/v/@kinosec/cli)](https://www.npmjs.com/package/@kinosec/cli)
+[![node](https://img.shields.io/node/v/@kinosec/cli)](https://nodejs.org)
+
+The official CLI for [KinoSec](https://kinosec.ai) — run pentests from your terminal.
+
+## Install
+
+```bash
+npm install -g @kinosec/cli
+```
+
+Or run without installing:
+
+```bash
+npx @kinosec/cli scan list
+```
+
+Or download a standalone binary from [GitHub Releases](https://github.com/kinosec-ai/cli/releases) — no Node.js required.
+
+See [docs/install.md](docs/install.md) for all installation methods.
+
+## Quick Start
+
+```bash
+# Authenticate with a Personal Access Token
+kns auth login
+
+# List your assets
+kns asset list
+
+# Run a quick pentest
+kns scan create --asset <id> --mode quick
+
+# Watch progress in real-time
+kns scan watch <scan-id>
+
+# View findings
+kns finding list --scan <scan-id>
+
+# Export a report
+kns report export --scan <report-id> --format markdown > report.md
+```
+
+See [docs/quickstart.md](docs/quickstart.md) for a full walkthrough.
+
+## Commands
+
+```
+kns auth login|status|logout        Manage authentication
+kns config set|get|list             Manage CLI configuration
+kns me                              Show authenticated user info
+
+kns asset list|get|create|delete|verify   Manage assets
+kns scan list|get|create|cancel|watch     Manage security scans
+kns finding list|get|update|retest        Manage findings
+kns report list|get|export                Manage reports
+kns token list|create|revoke              Manage API tokens
+```
+
+Every command supports `--json` for machine-readable output and `--help` for usage details.
+
+See [docs/commands.md](docs/commands.md) for the full command reference.
+
+## Authentication
+
+The CLI authenticates via Personal Access Tokens (PATs). Tokens are resolved in this order:
+
+1. `--token` flag
+2. `KINOSEC_TOKEN` environment variable
+3. `~/.config/kinosec/credentials.json` (saved by `kns auth login`)
+
+See [docs/authentication.md](docs/authentication.md) for details.
+
+## Example
+
+```bash
+$ kns auth login
+Paste your API token: ****
+✓ Authenticated as you@example.com
+  Plan: security_pro (pro)
+  Org: Acme Inc
+
+$ kns scan list
+ID                                   Target         Mode   Status      Created
+bc6b13bc-1234-5678-9abc-def012345678 example.com    quick  Completed   5/1/2026
+
+$ kns finding list --scan bc6b13bc-1234-5678-9abc-def012345678
+ID                                   Name              Severity  Status  Phase
+f1a2b3c4-...                         SQL Injection     Critical  open    active_scan
+```
+
+## Requirements
+
+- Node.js >= 20.0.0 (for npm install)
+- No requirements for standalone binaries
+
+## Contributing
+
+This CLI is maintained by [KinoSec](https://kinosec.ai). External contributions are not accepted at this time. Bug reports via Issues are welcome.
+
+## License
+
+Proprietary. See [LICENSE.md](LICENSE.md) for terms.

package/dist/cli.js

@@ -7750,7 +7750,7 @@ function parseApiError(body, status) {
     requestId: typeof b.request_id === "string" ? b.request_id : "unknown"
   });
 }
-var IDEMPOTENT_EXACT_PATHS = ["/v1/scans"];
+var IDEMPOTENT_EXACT_PATHS = ["/v1/scans", "/v1/tokens"];
 var IDEMPOTENT_SUFFIXES = ["/cancel", "/retest"];
 function needsIdempotencyKey(method, path) {
   if (method !== "POST") return false;