Subtext setup wizard

Session replay, built for agents. Subtext is agentic session review: it captures production sessions of your app and connects them to your coding agent — Claude Code, Cursor, Codex, Devin, your own harness — so it can review what real users did, reproduce reported bugs, verify its own UI changes, and manage capture privacy rules, all without leaving the terminal.

This wizard is the fastest way to set that up. One command, run in your project directory:

npx @subtextdev/subtext-wizard

Requires a free Subtext account — no credit card. Subtext is a hosted service that records and stores your app's sessions. Your account is where they live, and where your agent reads them from. When the wizard opens the login page, create an account, then come back to finish.

What it does

1. Signs you in — opens Subtext in your browser to log in or create your free account.
2. Fetches your capture snippet — grabs the session-capture snippet for your org.
3. Asks about your stack — pick the analytics and product tools you use (PostHog, Amplitude, Mixpanel, Sentry, Segment, and more) so setup can link them up.
4. Finds your coding agent — detects Claude Code, Codex, Gemini CLI, Cursor, Windsurf, VS Code, Zed, or Claude Desktop.
5. Hands the install to your own agent — no bundled agent; it drives the one you already use to wire up the capture snippet, MCP server, skills, and commands.

When it finishes, your agent is connected to your sessions. See the Subtext repo for what it can do from there.

What runs on your machine: the wizard hands the install to your own coding agent and runs it autonomously against the target directory — editing files, and (depending on the agent) running commands, with approvals auto-accepted. It also has the agent fetch Subtext's docs. Run it in a project directory you trust, and review the changes (and subtext-setup-report.md) before you deploy. The wizard asks you to confirm before the agent launches; pass --yes only for trusted, non-interactive/CI use.

Options

--dir <path>            App directory to instrument (default: current directory)
--api-key <key>         Skip the browser login and use this access token
--agent <id>            Skip the agent picker (claude-code, codex, gemini, cursor,
                        windsurf, vscode, zed, claude-desktop, manual)
--integrations <list>   Comma-separated tools to target, skips the picker
--print-prompt          Print the install prompt instead of launching an agent
--no-telemetry          Disable usage telemetry (otherwise the wizard asks for
                        consent after login; never collects code or data)
--debug                 Verbose output
--help                  Show all options

Development

Requires Node 18.17+.

npm install
npm run build             # tsc → dist/
node dist/bin.js --mock   # run the full flow with no network calls