---

標準のチャット履歴ポップアップが抱える4つの不満

自動英語タイトルが変えられず過去ログが迷子

まず「そもそも標準の履歴ポップアップ自体を設定でカスタマイズできないのか？」とエディタ内部のフロントエンド実装を調査しました。その結果、標準ポップアップには次の仕様がハードコード（固定実装）されていることが分かりました。

1. タイトルの自動命名・リネーム UI なし : 会話開始時に AI が自動で付けたタイトル（英語になりがち）がそのまま固定され、ユーザーが後から日本語の分かりやすい名前に変更する欄がありません。
2. collapseLargeGroups: true による強制折りたたみ : 履歴が増えると直近の数件以外は Show 97 more... のように自動で折りたたまれ、毎回クリックして展開する手間が発生します。
3. ホバー時しか出ない 1 件ずつの削除ボタン : 不要なテスト会話をまとめて整理したくても、行にマウスカーソルを乗せた時だけ右端にゴミ箱アイコンが出る仕様で、一括アーカイブができません。
4. 検索対象が「タイトル文字列の部分一致」のみ : これが最大の弱点です。「あのコマンドを実行した会話」「あのエラーが出た時のやり取り」を本文から横断検索することができません。

強制折りたたみとタイトル検索のみの限界

ここで「エディタ本体の JavaScript ファイルに直接パッチを当てて折りたたみを解除する」という荒技も技術的には可能ですが、それをやると エディタの自動アップデートが来るたびに上書きされて元に戻ってしまう（最悪の場合、署名検証エラーで起動しなくなる） という致命的な弱点があります。

一方、会話ログの実体データ（発言テキスト、AI の回答、思考プロセス、ツール実行履歴）は、すべて手元の Mac 内（~/.gemini/ 配下の SQLite データベースおよび transcript.jsonl）に構造化データとして保存されています。「本体を壊さず、このローカルデータを読み取って macOS 純正メールのような 3 カラム画面で表示すれば、アップデートにも 100% 影響されない最強の履歴ツールになる！」という結論に至りました。

---

macOSメール風3カラム履歴ツールの設計と機能

一覧と本文が常時並ぶ3カラムと全文検索

目指したのは、わざわざ 1 件ずつ開いたり閉じたりしなくて済む 「macOS の『メール（Mail.app）』そのままの操作感」 です。完成した『Convo Mail』の画面構成は以下の 3 カラムになっています。

カラム位置	役割と表示内容	実装した快適ポイント
左ペイン（フォルダ列）	「すべての会話」「📌 ピン留め」「📅 今日」「🕒 直近7日間」「🗑️ アーカイブ」の切り替え	サブエージェント等の裏方ログに埋もれず、見たい期間のメイン会話だけをワンクリックで絞り込み可能。
中央ペイン（スレッド一覧）	会話タイトル、更新日時、最初の質問プレビュー、メッセージ数、ピン留め星マーク（★）	強制折りたたみゼロ！スクロールだけで何百件でも高速に見渡せ、⌘ + F で 本文まで含めた全文インクリメンタル検索 が瞬時に走る。
右ペイン（常時プレビュー）	選択中の会話の全やり取り（自分の質問、AI の回答、実行コマンド、思考プロセス）	ポップアップではなく常時右側に全文が開いているため、上下キーやクリックでメールをめくる感覚で過去ログを拾い読みできる。

外部メタデータJSONによるピン留めと改名保存

「タイトルを自由な日本語に変えたい」「よく見返す神回チャットを一番上にピン留めしたい」という要望を実現する際も、エディタ純正の SQLite データベース自体は絶対に直接書き換えない（読み取り専用にする） という安全設計を徹底しました。

純正データベースを外部から勝手に書き換えると、エディタ本体とロック競合を起こしたり、後述する「IDE 側の検索連携」が動かなくなったりするからです。代わりに、ピン留め状態・日本語のカスタムタイトル・アーカイブ状態だけを独立した軽量ファイル（convo_user_metadata.json）へ即時保存し、画面表示時に純正ログとマージする二層構造にしました。これなら純正データを 1 ビットも傷つけずに、何度再起動しても自分が付けた日本語タイトルとピン留めが永久に維持されます。

---

エディタ拡張機能としての統合と実装の落とし穴

ダークモードの文字潰れとポート重複の自動回避

最初は npm run convos（または日本語エイリアス npm run チャット履歴）でブラウザが開くローカルツールとして作り始めましたが、さらに使い勝手を極めるため、VS Code / Antigravity エディタ自身のネイティブ拡張機能 として組み込みました。

• 左端アクティビティバーの「📨」専用アイコン からいつでもサイドバー検索＆フルタブ 3 カラム表示を展開
• 画面下ステータスバーの $(mail) チャット履歴 ボタン からもワンクリック起動
• ソースコードはワークスペース内の tools/antigravity-convo-mail-ext/ に置き、拡張機能フォルダへシンボリックリンクを張ることで修正がリアルタイム反映される構成

実際に毎日使いながら潰した 3 つのリアルな実装トラブルと解決策 も共有しておきます。

// extension.js（『🚀 IDEで開く』押下時の純正タイトル逆引き＆ピッカー自動起動）
function handleOpenInIde(convoId, title) {
  if (!convoId && !title) return;

  // リネーム後の日本語名ではなく、IDE側データベースの純正タイトルを優先取得して記号を除去
  const ideTitle = getIdeTitle(convoId);
  let searchText = (ideTitle || (typeof title === 'string' ? title : '')).split('\n')[0].trim();
  searchText = searchText.replace(/^[★☆📌\s]+/, '').trim();
  const textToCopy = searchText || convoId;

  if (textToCopy) {
    vscode.env.clipboard.writeText(textToCopy);
  }

  // エディタ標準の会話選択ピッカーを自動で開き、⌘+V だけで即ジャンプ可能にする
  vscode.commands.executeCommand('conversationPicker.showConversationPicker');
}

公式ピッカー自動起動とローカル限定通信の守り

最後にセキュリティ面で絶対に忘れてはならない鉄則があります。こうした自分専用のローカル管理サーバーを Node.js 等で立てる際、server.listen(4567) のようにポート番号だけを書いてホスト名を省略すると、環境によっては 0.0.0.0（同じ Wi-Fi や LAN 内の他の端末からも覗ける状態）で待ち受けてしまう危険があります。

大切な会話ログを扱うローカルサーバーは、必ず server.listen(4567, '127.0.0.1')（ループバックアドレス限定バインド） を明示し、自分自身の Mac 内部からしか物理的にアクセスできないよう隔離することが鉄則です。

---

まとめ：不便なUIはAIと一緒に自分専用へ作り変える

既製品のアプリの「ちょっとした使いにくさ」も、昔なら我慢して使い続けるしかありませんでした。しかし今は、隣にいる AI に「標準履歴のここが不便だから、macOS のメールみたいな 3 カラム画面でピン留めと日本語リネームができる拡張機能を作ろう」と相談すれば、わずか数十分で自分専用の快適なコックピットが手に入ります。

• 純正データベースは読み取り専用で守り、ピン留めや日本語リネームは別 JSON で安全に永続化する
• ローカル管理サーバーは必ず 127.0.0.1 限定バインドにして外部からのアクセスを遮断する
• ダークモードの配色コントラストや EADDRINUSE などのエッジケースを実機で丁寧に潰す

毎日何十回も触る画面だからこそ、小さな引っかかりを自分好みに解消したときの爽快感は格別です。ぜひ身近な「ここがもうちょっと便利だったらいいのに」から、自分専用ツールの DIY に挑戦してみてください！