Subtext

Fullstory の Subtext

エージェント向けに構築されたセッションリプレイ。 Subtext はエージェント型のセッションレビューです。アプリの本番環境のセッションを記録し、コーディングエージェント（Claude Code、Cursor、Codex、Devin、独自のハーネスなど）に接続することで、エージェントは実際のユーザーの操作を確認し、報告されたバグを再現し、自身の UI 変更を検証し、キャプチャのプライバシールールを管理できます。すべてターミナルを離れずに行えます。

はじめに

最も手早く始めるには、セットアップウィザードを使います。プロジェクトディレクトリで実行してください。

npx @subtextdev/subtext-wizard

1つのコマンドでセットアップ全体を処理します。ログインし、組織のキャプチャスニペットを取得し、使用している分析ツールを尋ねた後、インストールをコーディングエージェントに引き継ぎます。エージェントがキャプチャスニペット、MCP サーバー、スキル、コマンドを設定します。数分で完了します。

無料の Subtext アカウントが必要です。クレジットカードは不要です。 Subtext は、アプリのセッションを記録して保存するホステッドサービスです。セッションはアカウントに保存され、エージェントはそこからセッションを読み込みます。ウィザードでログインページが開いたら、Google を使ってワンクリックでアカウントを作成し、その後戻ってセットアップを完了してください。

利用できる機能

セットアップが完了すると、エージェントで次のツールを利用できます。

• セッションレビュー — 記録されたセッションをエージェントに指定すると、ユーザーがたどった操作の流れ、コンソールエラー、ネットワークアクティビティ、問題が発生した箇所など、何が起きたかを確認できます。ユーザーから報告された問題のデバッグや、修正が実際の UI に反映されたことの確認に最適です。
• プライバシールール — キャプチャされたセッションの PII を検出し、要素のブロック、URL、ネットワークのキャプチャルールをエージェントから直接管理できます。

ライブブラウザーの操作と、コード変更前後の証拠のキャプチャは、コンパニオンの Subtext Verify プラグインで行います。

手動でセットアップする

自分で設定したい場合は、ウィザードが以下の手順を自動化します。代わりに手動で実行することもできます。

1. プラグインをインストールする

Claude Code

/plugin marketplace add fullstorydev/subtext
/plugin install subtext@subtext-marketplace

Cursor — Marketplace パネル（またはこのリポジトリをインポートした Team Marketplace）からインストールします。

Codex — /plugins を開き、リポジトリのマーケットプレイスから subtext をインストールします。

Gemini CLI

gemini extensions install https://github.com/fullstorydev/subtext

手動 / openskills

npx openskills install fullstorydev/subtext

…次に、以下の subtext MCP サーバーをエージェントの MCP 設定に追加します。

2. MCP サーバーに接続する

subtext サーバーは https://api.fullstory.com/mcp/subtext で稼働します。HTTP 専用のため、ローカルプロセスは不要です。

3. アプリにキャプチャスニペットを追加する

セッションを記録するため、組織用の Fullstory キャプチャスニペットをインストールします。ウィザードを使えば、組織のスニペットを使ってこの手順を実行できます。手動で行う場合は、Fullstory の設定からスニペットを取得してください。

補足

• すべてのツールは読み取り専用の分析用です。ただし、privacy-create / privacy-promote / privacy-delete / privacy-url-create / privacy-network-create は組織のプライバシールールを変更します。
• このプラグインには、スキルとして subtext-search（セッション内で起きたことからセッションを検索）、subtext-review（構造化されたセッション要約）、subtext-session（review-* ツールカタログ）、subtext-privacy（PII 検出と、要素のブロック／URL／ネットワークのプライバシールール）、subtext-telemetry（ワークフローのマイルストーン記録）、さらに subtext-shared と subtext-using-subtext が含まれています。
• また、.sightmap/ コーパスの構築と操作に使う sightmap スキル sightmap-authoring と sightmap-browser も含まれています。subtext-sightmap がコーパスとセッションレビューを連携させます。これらは sightmap プロジェクトからベンダー提供されているため、追加インストールは不要で、プラグインのインストール時にバイナリも必要ありません。

ベンダー管理された sightmap スキルのメンテナンス

skills/ 配下の sightmap-authoring と sightmap-browser のスキルは、sightmap プロジェクトからベンダー管理された状態で取り込まれているため、手作業で編集しないでください。これらのスキルは @sightmap/sightmap npm パッケージに含まれており、Subtext はこのパッケージを devDependency として固定し、scripts/sync-sightmap-skills.mjs でスキルをコピーしています。

更新するには：

npm install --save-dev @sightmap/sightmap@<version>   # bump the pin
npm run vendor-skills                                 # refresh skills/ + .sightmap-vendored.json

その後、変更をコミットします。.sightmap-vendored.json には、取り込み元のパッケージと、取り込まれた正確なバージョンが記録されています。スキルの内容に関する修正は、こちらではなく sightmap リポジトリに反映してください。