Turnlane

使い方ガイド · Claude Code + Codex

次に自分が対応するAIは、どれ?

AIを2〜3本並べて動かすと、タブを順番に確かめること自体が仕事になります。Turnlaneの「自分の番」で、返答・許可・レビューを待っている作業を見つけ、元の作業へ戻りましょう。

macOS 14以降 · Apple Silicon · 無料・オープンソース

初期設定 · 自分の番の使い方 · 通知の仕組み

Turnlaneの自分の番。待っている作業の一覧と、選んだ作業のタイムライン。
ダミーデータを使った画面例です。「自分の番」に、さまざまな理由で待っている作業が並びます。

まず「何を待っているか」を見る

ひとつのAIにリファクタ、もうひとつに不具合の調査を任せ、自分の作業へ移る。戻ってみると、ひとつは許可を求め、別のAIは質問し、もうひとつは変更の確認を待っています。通知は気づくきっかけに、一覧は今も対応が必要なものを確かめる場所になります。

  1. 「自分の番」を開く。件名、リポジトリ、待っている理由、経過時間を見ます。ボードでは、自分のタスクやカレンダーとAIの作業が同じ日に並びます。
  2. 対応する前に中身を読む。詳細を開いて、確認できる情報を見ます。許可、質問、PRのレビュー、エラーでは、必要な対応が違います。
  3. 「開いて対応」を選ぶ。対応する端末でセッションが動いていれば、そのタブが前に出ます。そこで返答するか、対応している場合はTurnlaneの「答える」を使えます。送るのは自分で送信した内容だけです。Turnlaneが答えを決めたり、自動で許可したりはしません。
  4. 後でよいものは後へ回す。スヌーズするか、状況に応じて「完了」または「対応不要」にします。AIが先へ進んだことをTurnlaneが検知すると、自動で閉じる項目もあります。

Codexの動いているタブへ戻る操作と、Turnlaneからの回答にはhooksが必要です。端末にも条件があります。tmux、ターミナル、iTerm2、Ghostty 1.3以降、Orcaには対応する経路があり、WarpとKittyで「答える」を使うにはtmuxが必要です。デスクトップアプリの記録は取り込めますが、そのチャット画面へ「答える」で送信することはできません。元のセッションを自分で開いて確認することもできます。

普段使っているAIで試す

macOS 14以降のApple Silicon Macと、ローカルのClaude CodeまたはCodexのセッションが必要です。Turnlaneのアカウントは要りません。

1. インストールして開く

ZIPを展開し、Turnlaneをアプリケーションフォルダへ移して開きます。Homebrewでもインストールできます。

brew install --cask turnlane/tap/turnlane

2. 取り込む記録を選ぶ

初期設定でエージェントの記録フォルダを選び、取り込みに同意します。直近7日分の作業が取り込まれます。カレンダーへのアクセスと通知は任意です。カレンダーをつながなくても、AIの一覧を試せます。

Claude DesktopのCodeタブとCodexのデスクトップアプリも、同じ形式のローカル記録を使います。Webのチャット、Claudeの通常のチャット画面、ChatGPTのチャットは取り込みません。

3. hooksを追加して、待ちを早く拾う

初期設定の画面でTurnlaneのhooksを入れるか、CLIで次を実行します。

turnlane hooks install

ZIPで入れた場合は、先に初期設定か「設定 → 一般」でコマンドラインツールをインストールします。Homebrewの場合はPATHに追加されます。hooksを入れたら、起動中のClaude CodeとCodexを再起動してください。Codexでは /hooks を実行し、Turnlaneの項目を承認します。

作業の取り込みと表示にhooksは必須ではありません。入れない場合はローカル記録から待ちを推定するため、表示まで1分ほどかかることがあります。Codexの「開いて対応」「答える」には、動いているプロセスを特定するためhooksが必要です。外すときは turnlane hooks uninstall を使います。

4. 普段の作業で、ひとつ確かめる

いつもの作業を続け、次にAIが入力を求めたり確認する結果を残したりしたら、「自分の番」の行と理由を見てください。「開いて対応」が使えれば、そこから戻れます。一覧を試すためだけに許可待ちを作る必要はありません。

行が出る時刻と、通知が届く時刻は別

「自分の番」は一覧の名前です。内部の状態では、許可や入力を求めて止まっているものが needs_input、ターンが終わって返答やレビューを待つものが your_turn です。エラーも一覧に出ることがあります。

  • 許可や入力で止まったとき:hooksから速く信号を受け取ります。ただし許可待ちの通知は10秒待ちます。すぐ解決して先へ進んだ許可で、作業を中断させないためです。
  • 質問でターンが終わったとき:Macの前にいれば、既定で15分の猶予があります。その間は薄い行で表示され、一覧の件数には入りません。猶予が過ぎると通常の行になります。長さは設定で変更できます。ターンが終わったときに席を外していれば、この猶予はありません。
  • 通知:新しい許可・入力待ちやエラーは即時通知の対象で、許可待ちには上記の10秒の待機があります。それ以外の「自分の番」は15分ごとにまとめて通知します。質問の猶予と、まとめ通知の間隔は別の仕組みです。

バナーを受け取るには、Turnlaneのデスクトップアプリを起動し、macOSで通知を許可してください。Turnlaneの集中モードでは通知を保留し、終了時にまとめます。許可・入力待ちだけを通す設定もあります。macOS側の設定でバナーが抑えられることもあります。同じ項目は5分以内に再通知せず、初回の取り込みで過去の通知をまとめて出すこともありません。この一覧は現在の待ちを確認する場所で、通知履歴の保管場所ではありません。

行の時間は、待ちが始まってからの経過時間です。一方、その日の記録の「放置」(英語UIではIdle)は、猶予を過ぎてMacの前にいた時間を数え、不在とカレンダーの予定がある時間は除きます。

何を読み、何を残すか

Turnlaneは、Claude CodeとCodexのローカル記録と、任意で追加したhooksの情報を読みます。時刻、リポジトリ、ブランチ、状態などの作業情報を保存します。また、指示の先頭行、AIの問いと選択肢、許可を求めたツールとコマンドやパス、エラーの種類を、長さを制限し、可能な範囲で秘密を伏せて保存します。保存した中身は「設定 → データ」で保存を止めたり、削除したりできます。

セッション記録全体、差分、ファイルの内容をデータベースへコピーすることはありません。AIの最後の返答は、詳細を開いたときにローカル記録から読み、最大2,000文字の抜粋として表示しますが、保存はしません。Turnlaneのアカウント、クラウド同期、テレメトリはありません。更新の確認とダウンロードはGitHub Releasesに接続し、設定で止められます。自分のAIツールを呼ぶ機能や、MCPでデータを渡す機能には、それぞれ別のデータの受け渡しがあります。有効にする前にプライバシーの詳細(英語)をご確認ください。

最初の表示が想定と違ったら

  • 作業が出ない:使っているエージェントの記録フォルダを選び、取り込みに同意したか確認してください。
  • 質問の行が薄い:まだ猶予中かもしれません。バナーが出ていなくても、待っている作業がないとは限りません。
  • Codexへ戻れない・答えられない:hooksのインストール、/hooks での承認、セッション再起動後の反映を確認してください。
  • 行と会話の内容が合わない:記録からの判定は完全ではありません。元のセッションを確認し、必要に応じて「完了」または「対応不要」にしてください。

まず普段のやり取りをひとつ確かめて、その日の作業と一緒に見えると便利か試してください。インストールと初期設定へ戻るか、Turnlaneの概要をご覧ください。