Harness セッション履歴

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end --> Tesserae はローカルの AI-agent transcript をインポートし、静的サイトの sessions/ セクションでプロジェクトメモリとしてレンダリングできます。

この機能は意図的に export harness と分離されています。

• export harness は Claude Code、Codex、Gemini、Cursor、Kiro、OpenCode などのツール向けの outbound context です。
• sessions ... は inbound history です。現在のプロジェクトの過去の Claude Code/Codex セッションを正規化し、.tesserae/harness_sessions/ に保存し、export site がセッションの index/detail ページを公開できるようにします。

2 つの入口: バッチインポートとライブ監視

セッションの取り込みはもはやバッチ専用ではありません。同じ正規化ストアへ入る経路は 2 つあります。

• バッチインポート — sessions discover/import は要求に応じて transcript root をスキャンし、一度きりで書き込みます。本ページの以下でこのフローを説明します。
• ライブ監視 — supervisor daemon（tesserae engine）が SessionTailer を実行し、このプロジェクト自身の Claude Code と Codex transcript を監視して、新しい turn が届くたびに取り込みます。各 tick はファイルごとに永続化された byte offset へ seek し、届いた新しい byte だけを読み、debounce された再コンパイルを enqueue する前に完全な turn を SQLite HarnessSessionsDB（.tesserae/sqlite.db）へ保存するため、コンパイルは常に一貫した状態を読みます。tailer はプロジェクト自身のセッションにスコープが限定され（Claude projects/<slug>/*.jsonl；Codex は cwd でフィルタ）、再起動後は保存済み offset から再開し、turn を再生しません。

ライブループの実行:

tesserae engine        # ソースを監視し、バーストを統合し、自動再コンパイル
tesserae engine --once # 単一の drain サイクル後に終了（決定的）

tesserae refresh は長期 watcher を起動せず、同じ ingest → compile → project パイプラインを in-process で一度実行します（--skip-sessions で harness セッションの discovery スキャンをスキップ）。

プライバシーモデル

どちらの取り込み経路も明示的です。ライブ tailer は tesserae engine を起動し続けている間だけ動作し、バッチ discovery は --import でのみ書き込みます。通常の tesserae compile や tesserae export site は .tesserae/harness_sessions/ の正規化済みセッションと .tesserae/sqlite.db のライブレコードを読みますが、自分から非公開の harness transcript ディレクトリを不意に scrape することはありません。

インポートされたセッションレコードはローカルプロジェクトの成果物です。公開サイトに公開する前に確認してください。transcript に secrets、private paths、customer data、未公開コードが含まれる可能性がある場合は特に重要です。

ローカルセッションの検出とインポート

プロジェクトルートで:

tesserae sessions discover --import

Discovery は現在のプロジェクト作業ディレクトリに属するローカル Claude Code と Codex transcript root をスキャンします。特定の config ディレクトリをスキャンするには --root を使い、検出対象を制限するには --harness を繰り返します。

tesserae sessions discover \
  --root ~/.claude \
  --root ~/.codex \
  --harness claude-code \
  --harness codex \
  --import

--import なしでは、discovery は正規化セッションレコードを書き込まず、見つかった内容だけを表示します。

正規化 JSON を直接インポート

別のツールが正規化済みの HarnessSession JSON をすでに生成している場合、1 つのファイルまたはファイル一覧をインポートできます。

tesserae sessions import path/to/session.json path/to/more-sessions.json

各入力は 1 つのセッションオブジェクトまたはセッションオブジェクトのリストを含められます。

インポート済みセッションの一覧

tesserae sessions list

セッションは以下に保存されます。

.tesserae/harness_sessions/
  manifest.json
  <harness>/
    <session>.json
    <session>.md

ライブ監視されるセッションは SQLite HarnessSessionsDB（.tesserae/sqlite.db）にも追跡され、ここには tailer が再開に使うファイルごとの read offset も永続化されます。sessions list は統合されたビューを報告します。

静的セッションページをビルド

セッションをインポートした後、サイトを再ビルドします。

tesserae export site

サイトは次を出力します。

.tesserae/site/sessions/index.html
.tesserae/site/sessions/<project>/<session>.html

生成されたサイトは global rail、home Browse cards、search entries、各 session detail page の breadcrumb trail から Sessions へリンクします。

セッション詳細ページのレイアウト

セッション詳細ページは単独の transcript dump ではなく、共有の static-site shell を使います。含まれるもの:

• hero と stat strip;
• high-level summary;
• timeline と size metadata;
• 存在する場合は decisions、files、commands、tools、errors;
• 折りたたまれた subagent tree;
• turn ごとの user/assistant conversation;
• 直前の assistant turn の下に付く折りたたみ tool-use blocks;
• #turn-N anchors にリンクする左側 conversation rail。

会話 markdown はサイトの markdown renderer を通してレンダリングされます。inline code、明示的な command/tag markup、paths、filenames、hashtags などの意味的な表面は compact chips として装飾されます。ランダムな大文字名詞は自動で chip 化されません。

現在の transcript typography:

セッション公開チェックリスト

セッションを含む公開サイトをデプロイする前に:

1. tesserae sessions list を実行し、件数が想定どおりか確認します。
2. 機密情報がないか .tesserae/harness_sessions/ を確認します。
3. tesserae export site で再ビルドします。
4. ローカルで sessions/index.html と少なくとも 1 つのセッション詳細ページを開きます。
5. tool blocks がデフォルトで折りたたまれ、raw tool payloads を公開してよいことを確認します。
6. source tree を commit した後、tesserae export site --deploy でデプロイします。