throughline weekly downloads statistics

<p align="center"> <img src="https://raw.githubusercontent.com/kitepon/Throughline/main/.github/og.png" alt="Throughline — a whale family carrying direction and memory across changing boundaries" width="100%"> <br> _{<em>This image represents continuity that preserves relationships, direction, and memory even as environments and boundaries change.</em>} </p>

Throughline

English · 日本語

Cut ~90% of Claude Code's context usage while keeping nearly all the memory. Throughline separates conversation by type, not time — humans-readable text stays, machine-generated tool output retires to SQLite. Same decisions, same context, 90% lighter.

Built and maintained by Quo at kitepon.dev.

Codex Desktopの自動継続

throughline auto-handoff enable --project /absolute/project/path
throughline auto-handoff status --json
throughline auto-handoff disable

既定では無効です。enableは必要なPreCompact(auto)フックを登録し、そのフックの承認と有効状態を公式APIで確認します。--projectを省略すると全projectを対象にします。macOS・Windows・LinuxのCodex Desktopで実機確認済みです（Windowsは0.16.6から、Linuxは0.16.7から）。Codex Desktopに同梱のCodexが0.162以上の時は、0.16.7以上が要ります。VS Code・CLIの自動継続は未検証です。

自動圧縮の開始前に旧ターンを停止し、同じprojectの新しいタスクへ記憶を注入して表示します。新しいタスクには、前任のタスクの題から<project名>｜<作業の概要>（自動引き継ぎ）の名前を付けます。後継が作業を続けたのを確かめた後、旧タスクの名前の頭へ【引き継ぎ済み】を付けます（0.16.10から。それより前の版が引き継いだ分はthroughline auto-handoff mark-sourcesで付け直せます。名前の無い後継にも名前が付きます。--dry-runで、付ける名前だけを先に見られます）。一覧で、印の無い1本が今の続きです。元のモデル・推論強度・権限・モードなどが表示後も一致することを確認してから、継続指示を一度だけ送ります。後継でその入力と作業の進捗を観測して完了とします。手動/compactは発火対象に含めません。0.16.45以降、停止前の確認で実行中のCodexゴール（/goal）を検出した場合は、新しい会話への切替を見送ります。元の会話・ゴールを止めず、Codexの通常処理とThroughlineの記録を続けます。警告の理由はhandoff_active_goal_conditional_resume_unavailableです。停止済みのゴールは停止したまま後継へ運びます。ゴールの読取に失敗した場合も、停止前に失敗を明示して元の会話を継続します。これは実行中のゴールの自動切替を制限する暫定対応です（停止前の判断と制約）。

0.16.39から、要約の準備が済んだことを確認してから旧ターンの停止を許可します。要約backendの混雑・通信失敗、worker起動失敗、20秒以内に準備できない場合は、引き継ぎ失敗を警告し、旧ターンやゴールを停止しません。この場合、Codex自身の圧縮と元の会話の処理を継続します。引き継ぎ成功とは記録せず、別モデルへの切替もしません。遅れたworkerは後継を起動しません。停止後の作成・設定確認・配送で起きる失敗や結果不明は、従来どおり固定理由を残し、重複実行を防ぐため自動で旧タスクを起こしません。

記憶は引き継ぎ全体の直近20ターンをL2全文、それより古いターンをL1で渡します。元のユーザー依頼と中断地点を保持し、tool結果とThinkingは注入しません。本文内のauto-handoff detailコマンドで、凍結したL2/L3を引き継ぎID・origin・turnから取得できます。A→B→Cの連続引き継ぎでも祖先の詳細を取得できます。

設定不一致、実行中の子agentや既知のnativeコマンドでは固定理由を残して停止します。手動の引き継ぎなど、前任をさかのぼれない記憶を受け取ったタスクは、受け取った記憶をそのまま後継へ渡して引き継ぎます（0.16.13から。それより前の版は、ここで引き継ぎを止めていました）。旧タスクの順番待ちに残っている入力（まだ送られていない物）は、後継が作業を続けた後に、順番を保って後継の順番待ちへ運びます（0.16.12から。それより前の版は、ここで引き継ぎを止めていました）。失敗時はローカルの説明ページを開きます。新タスクだけで容量が尽きる場合も、新タスクを増やし続けません。結果不明の指示は自動で再送しません。

throughline auto-handoff status --operation <handoff-id> --json
throughline auto-handoff resume --operation <handoff-id> --json

あるタスクの今の続きは、次の命令で引けます（読むだけ。ほかの道具が、旧タスクあての連絡を今の続きへ渡す時に使います）。

throughline auto-handoff successor --thread <codex-thread-id> --json

current_thread_idが今の続きです（後継が無ければ渡したID自身）。pending.in_flightがtrueの間は、引き継ぎの途中です。 停止前の準備失敗で元の会話が継続する場合、または後継作成前の失敗後に元の会話で実作業を再開した場合は、 古い失敗をpendingに返しません。履歴はstatusに残ります。作成・注入の結果不明、既知の後継、 元記録を確認できない失敗は引き続き返します（ADR 0072）。 準備失敗時は、警告に示す本人の元の会話で続けてください。要求の照合自体が失敗した場合も、 既存の作用や担当の移転が無いと確認できれば元の会話を継続します。 既存の後継・実行中の引き継ぎ・結果不明や状態の読取不能は保護を維持します。内部の子作業は担当が管理します。

原因を解消した後のresumeは同じ引き継ぎと既知の後継を再利用します。配送後の結果不明は実際の入力・開始を観測した場合だけ回復し、作成結果が不明な後継は再作成しません。従来の手動$throughlineとcurrent-thread実験の設定は独立しています。

実測と検証範囲、Windowsの実測、Linuxの実測を参照してください。

Claude Codeの自動継続

throughline auto-handoff enable --host claude --project /absolute/project/path
throughline auto-handoff status --host claude --json
throughline auto-handoff disable --host claude

既定では無効です。enableは必要なPreCompact・PreToolUse・Stopのフックを登録し、disableが外します。--projectを省略すると全projectを対象にします。Codexの設定とは別で、互いに影響しません。

自動圧縮を置き換えます。圧縮が走る前に旧い会話を止め、記憶を持った新しい会話で作業を続けます（ADR 0033）。

1. 自動圧縮の直前に、圧縮を止めて、引き継ぎを予約します。
2. 旧い会話の次の道具を保留し、後継の起動と受領を待ちます。受領後に旧い応答を止めます。起動失敗なら最初の道具から通し、元の応答を継続します（ADR 0068）。
3. 同じprojectに、継続の指示を最初の指示として付けた新しいClaudeの会話を裏で立てます。Windowsは共有の背景サービスを使わず、非表示の端末で直接起動します。Linux/macOSはclaude --bgを使います（ADR 0069）。会話の名前は、前任の会話の題から<project名>｜<作業の概要>（自動引き継ぎ）にします。モデル・推論強度・権限は旧い会話から引き継ぎます。
4. 最初の指示を受け取った時に、止めた時点の依頼、そのターンでここまでにしたこと（発言と道具の呼び出し）、実行されなかった道具、直近の会話の原文を注入します（上限9,500字）。止めたターンの道具の入出力は、後継がthroughline detailで取り出せます。…