@piperace/cli 1.5.11 → 1.5.13

package/README.md

@@ -1,48 +1,82 @@
 # Piperace
 
-Expose your localhost to the internet in seconds — a self-hosted alternative to ngrok. Share a local server behind NAT or a firewall with a stable public URL and real TLS, using a single command.
+**The missing toolkit for localhost.** Public tunnels, trusted local HTTPS
+domains and traffic inspection — one binary, one command. No config, no cloud.
 
 🌐 **[piperace.com](https://piperace.com)**
 
-![Expose localhost with a single command](https://piperace.com/images/piperace_noqr.jpg)
-
 ## Install
 
 ```bash
 npm install -g @piperace/cli
 ```
 
-## Usage
+Works out of the box, no account required. `piperace login` keeps a stable
+subdomain and a permanent token.
+
+## The three things it does
+
+**Share a local port.** A real HTTPS URL for anything running on your machine,
+through a tunnel that dials out — nothing on your side starts listening on the
+network.
 
 ```bash
-piperace http 3000 -d myapp     # expose localhost:3000 → https://myapp.piperace.fun
-piperace login                  # keep the same subdomain + a permanent token
-piperace ui                     # open the Piperace Control Center (web UI) in your browser
-piperace --version
+piperace http 3000 -d myapp     # → https://myapp.piperace.fun
+piperace http 3000 8000 9000    # several ports at once
+piperace tcp 5432               # raw TCP, or `tls` for a terminated tunnel
 ```
 
-Works out of the box — no account required. When a tunnel starts, a QR code is printed so you can open it on your phone. Run `piperace login` to keep a stable subdomain and a permanent token.
+**Serve it locally over real HTTPS.** A trusted certificate on a `.local`
+domain, offline, with no tunnel involved — for the code paths that only run
+under HTTPS: secure cookies, service workers, WebAuthn, mixed-content rules.
+
+```bash
+piperace local 3000 -d myapp        # → https://myapp.local
+piperace local web:3000 api:8001    # several apps, one command
+```
 
-![Scan the QR code to open the tunnel on your phone](https://piperace.com/images/piperace_qr.png)
+**See every request.** Traffic through either of the above is captured and
+browsable: method, status, timing, headers and bodies, with secrets redacted.
+From there you can replay a request, mock a response, or inject a fault to see
+how your app handles one.
 
-## Supported platforms
+```bash
+piperace ui     # the Control Center: domains, tunnels, Inspect, settings
+```
+
+## For AI agents
+
+Piperace ships an **MCP server**, so an agent can read the captured traffic
+rather than be told about it — "why did that request 500?" answered from the
+real request and response.
+
+```bash
+claude mcp add piperace -- piperace mcp
+```
 
-The CLI is available for:
+The Control Center can also expose a small, explicit set of commands you allow
+(`docker ps`, `tail`, `systemctl status`) to an agent on another machine.
+There is no shell behind it: a command is a program plus typed parameters, so a
+value can never turn into another command, and anything not on the list waits
+for you to approve it.
+
+## Supported platforms
 
-| OS      | Architecture           |
-|---------|------------------------|
-| macOS   | Apple Silicon (arm64)  |
-| macOS   | Intel (x64)            |
-| Linux   | arm64                  |
-| Linux   | x64                    |
-| Windows | x64                    |
-| Windows | ia32                   |
+| OS      | Architecture          |
+|---------|-----------------------|
+| macOS   | Apple Silicon (arm64) |
+| macOS   | Intel (x64)           |
+| Linux   | arm64                 |
+| Linux   | x64                   |
+| Windows | x64                   |
+| Windows | ia32                  |
 
 ## Environment variables
 
 - `PIPERACE_ENV` — `development` or `production` (selects the API/tunnel endpoints).
 - `PIPERACE_BINARY_PATH` — use a specific Piperace executable instead of the managed one.
-- `PIPERACE_DOWNLOAD_URL` — override the base URL Piperace uses to fetch its components (default: `https://piperace-downloads.s3.us-east-1.amazonaws.com`).
+- `PIPERACE_DOWNLOAD_URL` — override where Piperace fetches its components
+  (default: `https://piperace-downloads.s3.us-east-1.amazonaws.com`).
 
 ## Programmatic API
 
@@ -56,7 +90,8 @@ await piperace.run(['http', '3000', '-d', 'myapp'], {
 
 ## macOS note
 
-If macOS shows an “unidentified developer” warning, Piperace clears the quarantine flag automatically on first run so the app can start.
+If macOS shows an "unidentified developer" warning, Piperace clears the
+quarantine flag automatically on first run so the app can start.
 
 ## License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@piperace/cli",
-  "version": "1.5.11",
-  "description": "Piperace — expose your localhost to the internet in seconds. A self-hosted ngrok alternative.",
+  "version": "1.5.13",
+  "description": "Piperace — the missing toolkit for localhost: public tunnels, trusted local HTTPS domains and traffic inspection, with an MCP server for AI agents. One binary, one command.",
   "main": "lib/index.js",
   "bin": {
     "piperace": "bin/piperace"
@@ -16,17 +16,18 @@
     "ngrok",
     "localhost",
     "expose",
-    "cli"
+    "cli",
+    "https",
+    "local-https",
+    "inspect",
+    "mcp",
+    "debugging"
   ],
   "author": "Piperace Team",
   "license": "MIT",
   "homepage": "https://piperace.com",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/piperace/piperace-npm.git"
-  },
   "bugs": {
-    "url": "https://github.com/piperace/piperace-npm/issues"
+    "email": "support@piperace.com"
   },
   "engines": {
     "node": ">=14.0.0"