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 project automatically: live transcript, time attribution, tickets, and an observer digest. The agent does not have to cooperate, or even know.

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; 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

Quick start

1. Create a free account at 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 · Free tier includes 1 connected worker; Pro includes 3.

Requirements

Node.js 18+. A ctlsurf account (free tier works).