@phenx-inc/ctlsurf 0.14.0 → 0.14.2

package/README.md

@@ -0,0 +1,36 @@
+# ctlsurf worker
+
+The terminal that remembers. Run Claude Code, Codex, or any coding agent inside it, and everything about the session lands in your [ctlsurf](https://ctlsurf.com) project automatically: live transcript, time attribution, tickets, and an observer digest. The agent does not have to cooperate, or even know.
+
+```bash
+npx @phenx-inc/ctlsurf
+```
+
+Works as a desktop app (macOS, Windows) or fully headless on a server.
+
+## What you get
+
+- **A normal terminal.** Your agent runs in a managed PTY that behaves like the terminal you already use. Agent-agnostic by design: Claude Code today, Codex tomorrow, whatever ships next.
+- **Watch and drive it from anywhere.** The session streams live to your project at [app.ctlsurf.com](https://app.ctlsurf.com); open a browser on another machine to watch the agent work, and type back into the session remotely.
+- **Automatic time tracking.** Each session becomes rows in the project's time-tracking datastore. The billing report reads straight from it.
+- **Tickets from the terminal.** File a ticket without leaving the session; it lands on a cross-project board.
+- **The Observer.** A supervision layer that tails the agent's transcript and the terminal's activity into an append-only local ledger, producing findings and time spans, with a session-end digest written to your project. Advisory only: every code path is wrapped so observation can never block or slow the working agent.
+
+## Why outside-in recording
+
+ctlsurf's task completions make agents document their own work, with structure enforced by the API. The worker is the second witness: an independent record of what actually happened in the terminal, when, and for how long. When the two records agree, you have provenance you can defend to a client weeks later. When they disagree, you have found something worth looking at.
+
+The 42-second story: [youtu.be/Ey0Wc3HW_ww](https://youtu.be/Ey0Wc3HW_ww)
+
+## Quick start
+
+1. Create a free account at [app.ctlsurf.com](https://app.ctlsurf.com)
+2. `npx @phenx-inc/ctlsurf` in your project directory
+3. Pair with your account when prompted (one-time device code)
+4. Run your agent as usual; open your project in the browser to see the live session
+
+Docs: [ctlsurf.com/docs](https://ctlsurf.com/docs) · Free tier includes 1 connected worker; Pro includes 3.
+
+## Requirements
+
+Node.js 18+. A ctlsurf account (free tier works).

package/out/headless/index.mjs

@@ -17314,7 +17314,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@phenx-inc/ctlsurf",
-      version: "0.14.0",
+      version: "0.14.2",
       description: "Agent-agnostic terminal and desktop app for ctlsurf \u2014 run Claude Code, Codex, or any coding agent with live session logging and remote control",
       main: "out/main/index.js",
       bin: {
@@ -17350,7 +17350,12 @@ var require_package = __commonJS({
         "codex",
         "electron",
         "node-pty",
-        "xterm"
+        "xterm",
+        "ai-agent",
+        "mcp",
+        "agent-observability",
+        "provenance",
+        "time-tracking"
       ],
       license: "SEE LICENSE IN LICENSE",
       engines: {
@@ -17388,6 +17393,10 @@ var require_package = __commonJS({
       optionalDependencies: {
         bufferutil: "^4.1.0",
         "utf-8-validate": "^6.0.6"
+      },
+      homepage: "https://ctlsurf.com",
+      bugs: {
+        email: "phenx@phenx.io"
       }
     };
   }