htpx-cli 0.1.0

package/README.md

@@ -0,0 +1,274 @@
+# htpx
+
+A terminal-based HTTP interception toolkit with project-scoped isolation and a lazygit-style TUI.
+
+Capture HTTP/HTTPS traffic through a MITM proxy and inspect it in an interactive terminal interface. No browser extensions, no separate apps—just your terminal.
+
+## Features
+
+- **Project-scoped isolation** — Each project gets its own `.htpx/` directory, keeping traffic separate
+- **Interactive TUI** — Browse, inspect, and export requests with vim-style keybindings
+- **Full HTTPS support** — Automatic CA certificate generation and trust
+- **Session labelling** — Tag and filter traffic by session for organised debugging
+- **Export anywhere** — Generate curl commands or HAR files from captured requests
+- **Zero config** — Works out of the box with curl, wget, Node.js, Python, and more
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g htpx-cli
+
+# One-time shell setup (add to ~/.zshrc or ~/.bashrc)
+eval "$(htpx init)"
+
+# Start intercepting in your project directory
+htpx intercept
+
+# Make some requests...
+curl https://api.example.com/users
+
+# Open the TUI to inspect
+htpx tui
+```
+
+## Installation
+
+```bash
+npm install -g htpx-cli
+```
+
+**Requirements:** Node.js 20 or later
+
+### Shell Setup
+
+Add the following to your `~/.zshrc` or `~/.bashrc`:
+
+```bash
+eval "$(htpx init)"
+```
+
+This creates a shell function that properly sets up proxy environment variables in your current session.
+
+## Usage
+
+### Start Intercepting
+
+```bash
+# Basic interception
+htpx intercept
+
+# With a session label for filtering
+htpx intercept --label api-tests
+```
+
+This auto-starts the daemon, sets up the proxy, and configures your shell to route HTTP traffic through htpx.
+
+### Browse Captured Traffic
+
+```bash
+# View all requests
+htpx tui
+
+# Filter by session label
+htpx tui --label api-tests
+```
+
+### TUI Keybindings
+
+| Key | Action |
+|-----|--------|
+| `j` / `↓` | Navigate down |
+| `k` / `↑` | Navigate up |
+| `Tab` | Switch between list and details panes |
+| `c` | Export selected request as curl command |
+| `h` | Export all requests as HAR file |
+| `r` | Refresh request list |
+| `q` | Quit |
+
+### Other Commands
+
+```bash
+htpx status    # Check daemon status
+htpx stop      # Stop the daemon
+htpx clear     # Clear captured requests
+```
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Your Shell                                                 │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │  curl, wget, node, python...                        │   │
+│  │          │                                          │   │
+│  │          ▼                                          │   │
+│  │  HTTP_PROXY=localhost:54321                         │   │
+│  └─────────────────────────────────────────────────────┘   │
+│                          │                                  │
+└──────────────────────────┼──────────────────────────────────┘
+                           ▼
+┌─────────────────────────────────────────────────────────────┐
+│  htpx daemon                                                │
+│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐     │
+│  │ MITM Proxy  │───▶│   SQLite    │◀───│ Control API │     │
+│  │  (mockttp)  │    │  requests   │    │ (unix sock) │     │
+│  └─────────────┘    └─────────────┘    └─────────────┘     │
+└─────────────────────────────────────────────────────────────┘
+                           ▲
+                           │
+┌──────────────────────────┼──────────────────────────────────┐
+│  htpx tui                │                                  │
+│  ┌───────────────────────┴─────────────────────────────┐   │
+│  │ ● POST /api/users   │ POST https://api.example.com  │   │
+│  │   GET  /health      │ Status: 200 │ Duration: 45ms  │   │
+│  │   POST /login       │                               │   │
+│  │                     │ Request Headers:              │   │
+│  │                     │   Content-Type: application/  │   │
+│  └─────────────────────┴───────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+When you run `htpx intercept`:
+
+1. A daemon starts in the background with a MITM proxy
+2. Environment variables (`HTTP_PROXY`, `HTTPS_PROXY`, etc.) are set in your shell
+3. HTTP clients that respect these variables route traffic through the proxy
+4. Requests are captured and stored in a local SQLite database
+5. The TUI connects via Unix socket to display captured traffic
+
+### Project Isolation
+
+htpx creates a `.htpx/` directory in your project root (detected by `.git` or existing `.htpx`):
+
+```
+your-project/
+├── .htpx/
+│   ├── proxy.port      # Proxy TCP port
+│   ├── control.sock    # IPC socket
+│   ├── requests.db     # Captured traffic
+│   ├── ca.pem          # CA certificate
+│   └── daemon.pid      # Process ID
+└── src/...
+```
+
+Different projects have completely separate daemons, databases, and certificates.
+
+## Supported HTTP Clients
+
+htpx works with any client that respects the `HTTP_PROXY` environment variable:
+
+| Client | Support |
+|--------|---------|
+| curl | ✅ Automatic |
+| wget | ✅ Automatic |
+| Node.js (fetch, axios, etc.) | ✅ With `NODE_EXTRA_CA_CERTS` |
+| Python (requests, httpx) | ✅ With `REQUESTS_CA_BUNDLE` |
+| Go | ✅ Automatic |
+| Rust (reqwest) | ✅ Automatic |
+
+## Export Formats
+
+### curl
+
+Press `c` in the TUI to copy a request as a curl command:
+
+```bash
+curl -X POST 'https://api.example.com/users' \
+  -H 'Content-Type: application/json' \
+  -H 'Authorization: Bearer token123' \
+  -d '{"name": "test"}'
+```
+
+### HAR
+
+Press `h` to export all captured requests as a HAR file, compatible with browser dev tools and HTTP analysis tools.
+
+## CLI Reference
+
+### `htpx init`
+
+Output shell configuration for your `.zshrc`/`.bashrc`.
+
+### `htpx intercept [options]`
+
+Start intercepting HTTP traffic.
+
+| Option | Description |
+|--------|-------------|
+| `-l, --label <label>` | Label this session for filtering |
+
+### `htpx tui [options]`
+
+Open the interactive TUI.
+
+| Option | Description |
+|--------|-------------|
+| `-l, --label <label>` | Filter to requests from labelled sessions |
+
+### `htpx status`
+
+Show daemon status, including proxy port, active sessions, and request count.
+
+### `htpx stop`
+
+Stop the daemon gracefully.
+
+### `htpx clear`
+
+Clear all captured requests from the database.
+
+### `htpx project init`
+
+Manually initialise a `.htpx` directory in the current location.
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/mtford90/htpx.git
+cd htpx
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Type check and lint
+npm run typecheck
+npm run lint
+
+# Development mode (watch)
+npm run dev
+```
+
+## Troubleshooting
+
+### Certificate errors
+
+Some tools need explicit CA certificate configuration. htpx sets common environment variables automatically, but you may need to configure your specific tool:
+
+```bash
+# The CA certificate is at:
+cat .htpx/ca.pem
+```
+
+### Daemon won't start
+
+Check if another process is using the socket:
+
+```bash
+htpx status
+htpx stop
+htpx intercept
+```
+
+### Requests not appearing
+
+Ensure your HTTP client respects proxy environment variables. Some clients (like browsers) ignore `HTTP_PROXY` by default.
+
+## Licence
+
+MIT

package/dist/cli/commands/clear.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const clearCommand: Command;
+//# sourceMappingURL=clear.d.ts.map

package/dist/cli/commands/clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,YAAY,SA0BrB,CAAC"}

package/dist/cli/commands/clear.js

@@ -0,0 +1,30 @@
+import { Command } from "commander";
+import { findProjectRoot, getHtpxPaths } from "../../shared/project.js";
+import { isDaemonRunning } from "../../shared/daemon.js";
+import { ControlClient } from "../../daemon/control.js";
+export const clearCommand = new Command("clear")
+    .description("Clear all captured requests")
+    .action(async () => {
+    const projectRoot = findProjectRoot();
+    if (!projectRoot) {
+        console.log("Not in a project directory (no .htpx or .git found)");
+        process.exit(1);
+    }
+    const paths = getHtpxPaths(projectRoot);
+    const running = await isDaemonRunning(projectRoot);
+    if (!running) {
+        console.log("Daemon is not running");
+        process.exit(1);
+    }
+    try {
+        const client = new ControlClient(paths.controlSocketFile);
+        await client.clearRequests();
+        console.log("Requests cleared");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown error";
+        console.error(`Error clearing requests: ${message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=clear.js.map

package/dist/cli/commands/clear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.js","sourceRoot":"","sources":["../../../src/cli/commands/clear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,6BAA6B,CAAC;KAC1C,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC1D,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+/**
+ * Generate the shell function for htpx.
+ * This function wraps htpx intercept with eval so that environment
+ * variables can be set in the current shell.
+ */
+export declare function generateShellFunction(): string;
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAY9C;AAED,eAAO,MAAM,WAAW,SAIpB,CAAC"}

package/dist/cli/commands/init.js

@@ -0,0 +1,25 @@
+import { Command } from "commander";
+/**
+ * Generate the shell function for htpx.
+ * This function wraps htpx intercept with eval so that environment
+ * variables can be set in the current shell.
+ */
+export function generateShellFunction() {
+    const lines = [
+        "htpx() {",
+        '  if [[ "$1" == "intercept" ]]; then',
+        "    shift",
+        '    eval "$(command htpx intercept "$@")"',
+        "  else",
+        '    command htpx "$@"',
+        "  fi",
+        "}",
+    ];
+    return lines.join("\n");
+}
+export const initCommand = new Command("init")
+    .description("Output shell function for .zshrc/.bashrc (one-time setup)")
+    .action(() => {
+    console.log(generateShellFunction());
+});
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,KAAK,GAAG;QACZ,UAAU;QACV,sCAAsC;QACtC,WAAW;QACX,2CAA2C;QAC3C,QAAQ;QACR,uBAAuB;QACvB,MAAM;QACN,GAAG;KACJ,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,2DAA2D,CAAC;KACxE,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC"}

package/dist/cli/commands/intercept.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+/**
+ * Format environment variable exports for shell evaluation.
+ * Each line is a shell export statement.
+ */
+export declare function formatEnvVars(vars: Record<string, string>): string;
+export declare const interceptCommand: Command;
+//# sourceMappingURL=intercept.d.ts.map

package/dist/cli/commands/intercept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercept.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/intercept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAIlE;AAED,eAAO,MAAM,gBAAgB,SAmDzB,CAAC"}

package/dist/cli/commands/intercept.js

@@ -0,0 +1,59 @@
+import { Command } from "commander";
+import { findOrCreateProjectRoot, ensureHtpxDir, getHtpxPaths } from "../../shared/project.js";
+import { startDaemon } from "../../shared/daemon.js";
+import { ControlClient } from "../../daemon/control.js";
+/**
+ * Format environment variable exports for shell evaluation.
+ * Each line is a shell export statement.
+ */
+export function formatEnvVars(vars) {
+    return Object.entries(vars)
+        .map(([key, value]) => `export ${key}="${value}"`)
+        .join("\n");
+}
+export const interceptCommand = new Command("intercept")
+    .description("Output environment variables to intercept HTTP traffic")
+    .option("-l, --label <label>", "Label for this session")
+    .action(async (options) => {
+    const label = options.label;
+    // Find project root (auto-creates .htpx if needed)
+    const projectRoot = findOrCreateProjectRoot();
+    ensureHtpxDir(projectRoot);
+    const paths = getHtpxPaths(projectRoot);
+    try {
+        // Start daemon if not already running
+        const proxyPort = await startDaemon(projectRoot);
+        const proxyUrl = `http://127.0.0.1:${proxyPort}`;
+        // Register session with daemon
+        const client = new ControlClient(paths.controlSocketFile);
+        const session = await client.registerSession(label, process.ppid);
+        // Build environment variables
+        const envVars = {
+            HTTP_PROXY: proxyUrl,
+            HTTPS_PROXY: proxyUrl,
+            // Python requests library
+            SSL_CERT_FILE: paths.caCertFile,
+            REQUESTS_CA_BUNDLE: paths.caCertFile,
+            // Node.js
+            NODE_EXTRA_CA_CERTS: paths.caCertFile,
+            // htpx session tracking
+            HTPX_SESSION_ID: session.id,
+        };
+        if (label) {
+            envVars["HTPX_LABEL"] = label;
+        }
+        // Output env vars for eval
+        console.log(formatEnvVars(envVars));
+        // Output confirmation as a comment (shown but not executed)
+        const labelInfo = label ? ` (label: ${label})` : "";
+        console.log(`# htpx: intercepting traffic${labelInfo}`);
+        console.log(`# Proxy: ${proxyUrl}`);
+        console.log(`# Session: ${session.id}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown error";
+        console.error(`# htpx error: ${message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=intercept.js.map

package/dist/cli/commands/intercept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercept.js","sourceRoot":"","sources":["../../../src/cli/commands/intercept.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAA4B;IACxD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,UAAU,GAAG,KAAK,KAAK,GAAG,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;KACrD,WAAW,CAAC,wDAAwD,CAAC;KACrE,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAE5B,mDAAmD;IACnD,MAAM,WAAW,GAAG,uBAAuB,EAAE,CAAC;IAC9C,aAAa,CAAC,WAAW,CAAC,CAAC;IAE3B,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAExC,IAAI,CAAC;QACH,sCAAsC;QACtC,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,oBAAoB,SAAS,EAAE,CAAC;QAEjD,+BAA+B;QAC/B,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAElE,8BAA8B;QAC9B,MAAM,OAAO,GAA2B;YACtC,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,QAAQ;YACrB,0BAA0B;YAC1B,aAAa,EAAE,KAAK,CAAC,UAAU;YAC/B,kBAAkB,EAAE,KAAK,CAAC,UAAU;YACpC,UAAU;YACV,mBAAmB,EAAE,KAAK,CAAC,UAAU;YACrC,wBAAwB;YACxB,eAAe,EAAE,OAAO,CAAC,EAAE;SAC5B,CAAC;QAEF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;QAChC,CAAC;QAED,2BAA2B;QAC3B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QAEpC,4DAA4D;QAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/commands/project.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const projectCommand: Command;
+//# sourceMappingURL=project.d.ts.map

package/dist/cli/commands/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,cAAc,SAA0E,CAAC"}

package/dist/cli/commands/project.js

@@ -0,0 +1,13 @@
+import { Command } from "commander";
+import { ensureHtpxDir, getHtpxDir } from "../../shared/project.js";
+export const projectCommand = new Command("project").description("Manage htpx project configuration");
+projectCommand
+    .command("init")
+    .description("Initialise htpx in the current directory")
+    .action(() => {
+    const projectRoot = process.cwd();
+    const htpxDir = getHtpxDir(projectRoot);
+    ensureHtpxDir(projectRoot);
+    console.log(`Created ${htpxDir}`);
+});
+//# sourceMappingURL=project.js.map

package/dist/cli/commands/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/cli/commands/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAC;AAEtG,cAAc;KACX,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,GAAG,EAAE;IACX,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAExC,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC"}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const statusCommand: Command;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,aAAa,SAiCtB,CAAC"}

package/dist/cli/commands/status.js

@@ -0,0 +1,36 @@
+import { Command } from "commander";
+import { findProjectRoot, getHtpxPaths } from "../../shared/project.js";
+import { isDaemonRunning } from "../../shared/daemon.js";
+import { ControlClient } from "../../daemon/control.js";
+export const statusCommand = new Command("status")
+    .description("Show daemon status")
+    .action(async () => {
+    // Find project root
+    const projectRoot = findProjectRoot();
+    if (!projectRoot) {
+        console.log("Not in a project directory (no .htpx or .git found)");
+        process.exit(1);
+    }
+    const paths = getHtpxPaths(projectRoot);
+    // Check if daemon is running
+    const running = await isDaemonRunning(projectRoot);
+    if (!running) {
+        console.log("Daemon is not running");
+        process.exit(0);
+    }
+    try {
+        // Query daemon for status
+        const client = new ControlClient(paths.controlSocketFile);
+        const status = await client.status();
+        console.log("Daemon is running");
+        console.log(`  Proxy port: ${status.proxyPort}`);
+        console.log(`  Sessions: ${status.sessionCount}`);
+        console.log(`  Requests captured: ${status.requestCount}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown error";
+        console.error(`Error querying daemon: ${message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC/C,WAAW,CAAC,oBAAoB,CAAC;KACjC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,oBAAoB;IACpB,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAExC,6BAA6B;IAC7B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QAErC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/commands/stop.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const stopCommand: Command;
+//# sourceMappingURL=stop.d.ts.map

package/dist/cli/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,WAAW,SAuBtB,CAAC"}

package/dist/cli/commands/stop.js

@@ -0,0 +1,27 @@
+import { Command } from "commander";
+import { findProjectRoot } from "../../shared/project.js";
+import { isDaemonRunning, stopDaemon } from "../../shared/daemon.js";
+export const stopCommand = new Command("stop").description("Stop the daemon").action(async () => {
+    // Find project root
+    const projectRoot = findProjectRoot();
+    if (!projectRoot) {
+        console.log("Not in a project directory (no .htpx or .git found)");
+        process.exit(1);
+    }
+    // Check if daemon is running
+    const running = await isDaemonRunning(projectRoot);
+    if (!running) {
+        console.log("Daemon is not running");
+        process.exit(0);
+    }
+    try {
+        await stopDaemon(projectRoot);
+        console.log("Daemon stopped");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown error";
+        console.error(`Error stopping daemon: ${message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=stop.js.map

package/dist/cli/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../../src/cli/commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IAC9F,oBAAoB;IACpB,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6BAA6B;IAC7B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/commands/tui.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const tuiCommand: Command;
+//# sourceMappingURL=tui.d.ts.map

package/dist/cli/commands/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/tui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,UAAU,SAyBnB,CAAC"}

package/dist/cli/commands/tui.js

@@ -0,0 +1,27 @@
+import { Command } from "commander";
+import { render } from "ink";
+import React from "react";
+import { App } from "../tui/App.js";
+export const tuiCommand = new Command("tui")
+    .description("Browse captured HTTP traffic")
+    .option("-l, --label <label>", "Filter by session label")
+    .option("--ci", "CI mode: render once and exit after a short delay (for testing)")
+    .action((options) => {
+    const { waitUntilExit, unmount } = render(React.createElement(App, { label: options.label }));
+    // In CI mode, exit after a short delay to allow initial render
+    if (options.ci) {
+        setTimeout(() => {
+            unmount();
+        }, 500);
+    }
+    void waitUntilExit().then(() => {
+        // Print curl command if one was exported
+        const curl = globalThis["__htpxCurl"];
+        if (typeof curl === "string") {
+            console.log("\n--- Exported curl command ---\n");
+            console.log(curl);
+            console.log();
+        }
+    });
+});
+//# sourceMappingURL=tui.js.map

package/dist/cli/commands/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../../../src/cli/commands/tui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,8BAA8B,CAAC;KAC3C,MAAM,CAAC,qBAAqB,EAAE,yBAAyB,CAAC;KACxD,MAAM,CAAC,MAAM,EAAE,iEAAiE,CAAC;KACjF,MAAM,CAAC,CAAC,OAAyC,EAAE,EAAE;IACpD,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,MAAM,CACvC,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CACnD,CAAC;IAEF,+DAA+D;IAC/D,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;QACf,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,GAAG,CAAC,CAAC;IACV,CAAC;IAED,KAAK,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAC7B,yCAAyC;QACzC,MAAM,IAAI,GAAI,UAAsC,CAAC,YAAY,CAAC,CAAC;QACnE,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { program } from "commander";
+import { clearCommand } from "./commands/clear.js";
+import { initCommand } from "./commands/init.js";
+import { interceptCommand } from "./commands/intercept.js";
+import { projectCommand } from "./commands/project.js";
+import { tuiCommand } from "./commands/tui.js";
+import { statusCommand } from "./commands/status.js";
+import { stopCommand } from "./commands/stop.js";
+program.name("htpx").description("Terminal HTTP interception toolkit").version("0.1.0");
+program.addCommand(clearCommand);
+program.addCommand(initCommand);
+program.addCommand(interceptCommand);
+program.addCommand(projectCommand);
+program.addCommand(tuiCommand);
+program.addCommand(statusCommand);
+program.addCommand(stopCommand);
+program.parse();
+// test
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAExF,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAEhC,OAAO,CAAC,KAAK,EAAE,CAAC;AAChB,OAAO"}

package/dist/cli/tui/App.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Root TUI component for browsing captured HTTP traffic.
+ */
+import React from "react";
+interface AppProps {
+    label?: string;
+}
+export declare function App({ label }: AppProps): React.ReactElement;
+export {};
+//# sourceMappingURL=App.d.ts.map

package/dist/cli/tui/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../src/cli/tui/App.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAgC,MAAM,OAAO,CAAC;AASrD,UAAU,QAAQ;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,GAAG,KAAK,CAAC,YAAY,CAyI3D"}