HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Wallfacer – Claude Codeなどのためのターミナルセッションマネージャー

Show HN: Wallfacer – A terminal session manager for Claude Code, and more (github.com)

15 pointsby pradiptasarma8 コメント

要約

Wallfacerは、Claude Code、Cursor CLI、Kiro CLI、CodexといったAIコーディングセッションを管理するためのターミナルセッションマネージャーです。AIが生成する会話の記録が散らばって管理しにくくなる問題を解決し、セッションの命名、タグ付け、グループ化、検索、再開、削除を可能にします。TUI(テキストベースのユーザーインターフェース)とCLI(コマンドラインインターフェース)の両方を提供し、ローカルのSQLiteデータベースでメタデータを管理します。

全文翻訳

wallfacer

██╗    ██╗█████╗  ██╗     ██╗     ███████╗█████╗   ██████╗███████╗██████╗
██║    ██║██╔══██╗██║     ██║     ██╔════╝██╔══██╗██╔════╝██╔════╝██╔══██╗
██║ █╗ ██║███████║██║     ██║     █████╗  ███████║██║     █████╗  ██████╔╝
██║███╗██║██╔══██║██║     ██║     ██╔══╝  ██╔══██║██║     ██╔══╝  ██╔══██╗
╚███╔███╔╝██║  ██║███████╗███████╗██║     ██║  ██║╚██████╗███████╗██║  ██║
 ╚══╝╚══╝ ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝     ╚═╝  ╚═╝ ╚═════╝╚══════╝╚═╝  ╚═╝

A terminal session manager for Claude Code, Cursor CLI, Kiro CLI and Codex — see every AI coding session you've ever started, then name, tag, group, search, resume, or delete them, from a full-screen browser or straight from the command line.

[画像: Build Status] [画像: Release] [画像: GitHub Release] [画像: License]

[画像: demo]

なぜ

Claude Codeは、すべての会話を ~/.claude/projects/ の下に、現在いるディレクトリをキーとして、無題のJSONLファイルとして保存します。Kiro CLIは、単一のフラットな ~/.kiro/sessions/cli/ フォルダで同様のことを行い、Cursor CLIは各チャットを ~/.cursor/chats/ の下のハッシュ名ディレクトリに格納し、Codexはロールアウトを日付ごとに ~/.codex/sessions/ に保存します。数週間後には、4つのエージェントにまたがる数十個のトランスクリプトがあり、それらを区別できず、必要なものを見つける方法もありません。

wallfacerはそれらすべてをインデックス化します — 読み取り専用で、エージェントのファイルには一切触れません — そして、タイトル、タグ、プロジェクトを独自のローカルSQLiteデータベースに保持します。

特徴

  • すべてを一度に見る — すべてのセッションを、すべてのディレクトリとすべてのエージェントから、新しさ順にソート
  • 整理する — セッションの名前を変更、タグ付け、プロジェクトにグループ化
  • 検索する — タイトル、最初のプロンプト、ディレクトリ、プロジェクト、タグ全体を検索
  • 起動と再開 — 新しいセッションを開始したり、古いセッションに戻ったりできます。どこからでも
  • マルチエージェント — Claude Code、Cursor CLI、Kiro CLI、Codexを並べて表示。セッション開始時にエージェントを選択し、後でフィルタリングできます
  • 安全な削除 — rm はゴミ箱に移動します。--purge のみ永久削除です
  • TUIとCLI — 人間向けのフルスクリーンブラウザ、スクリプト用のサブコマンド + --json
  • 拡張可能 — エージェントはプラグイン可能なアダプターです。opencode はロードマップにあります

インストール

macOSまたはLinuxでHomebrewを使用する場合:

brew tap pradipta/wallfacer https://github.com/pradipta/wallfacer
brew install pradipta/wallfacer/wallfacer

フォーミュラは、別の homebrew-wallfacer タップではなく、このリポジトリにあります。これが、タップにURLを明記する必要がある唯一の理由です。その後、brew upgrade wallfacer は通常通り機能します。

またはGoで:

go install github.com/pradipta/wallfacer@latest

Go 1.22+が必要です。ビルド済みのバイナリはリリースページにあります。ソースからのビルドは開発ガイドで説明されています。

使用方法(2つの方法)

wallfacerは2つのフロントエンドを持つ単一のバイナリであり、どちらを取得するかはサブコマンドを渡したかどうかによって決まります:

入力するコマンド得られるもの
wallfacerTUI — フルスクリーンでインタラクティブなセッションブラウザ。ここから開始します。
wallfacer <command>CLI — スクリプトやマッスルメモリー用のワンショットサブコマンド。

これらは別々のツールではなく、切り替えるものはありません。両方とも同じSQLiteインデックスを読み書きするため、ブラウザでタグ付けしたセッションは wallfacer list --tag で即座に見つけることができ、その逆も同様です。TUIができることはすべて、サブコマンドでも可能です。

(標準出力がターミナルでない場合 — wallfacer | less、またはスクリプト内 — 引数なしのコマンドはブラウザを開かずにヘルプを表示します。)

クイックスタート

ブラウザを開いてそこから作業します:

wallfacer

またはシェルから操作します:

wallfacer new ~/work/api --title "Fix flaky auth tests"
wallfacer resume "fix flaky auth tests"    # タイトルまたはIDプレフィックスで
wallfacer search auth
wallfacer list --project api --json        # スクリプト用

TUI — wallfacer

引数なしの wallfacer は、フルスクリーンのセッションブラウザを開きます。左側にリスト、右側に詳細ペインがあり、ハイライトされているセッションに対して wallfacer show が表示するすべての情報が表示されます。

[画像: wallfacer session browser screenshot]

各行には、プロジェクト、タグ、ディレクトリ、経過時間、エージェントが表示されます。これは wallfacer list が表示するのと同じメタデータです。100列未満の場合、詳細ペインは横に移動し、リストが全幅を占めます。

キー操作
↑/↓ j/k移動
/タイトル、プロジェクト、ディレクトリ、タグ、エージェント名全体をファジー検索
P / T / Aプロジェクト / タグ / エージェントのフィルタをサイクル(フィルタなしに戻る)
xプロジェクト、タグ、エージェントのフィルタをクリア
tab詳細ペインを表示または非表示
enter再開 — ターミナルがエージェントに引き渡されます。ブラウザは終了時に戻ります
n新規セッション(エージェント、次にディレクトリ、タイトル、プロジェクト、タグを尋ねます)
r / t / p名前変更 / タグ編集 / プロジェクト設定
d削除 → ゴミ箱へ、確認あり
? / qヘルプ / 終了

エージェントの選択は最初に行われ、1行のピッカーです。←/→ または数字で選択し、enter で続行、esc で戻ります。Claude Codeはデフォルトで選択されており、登録されているアダプターが1つしかない場合はこのステップは完全にスキップされます。

CLI — wallfacer <command>

すべてのサブコマンドはワンショットです。実行、表示、終了します。ブラウザと同じインデックスを使用します。

コマンド実行内容
wallfacer(サブコマンドなし)インタラクティブブラウザを開く
wallfacer new [dir] [--agent A] [--title T] [--project P] [--tag t]ディレクトリで新しいセッションを開始する
wallfacer resume <ref>セッションを元のディレクトリで再オープンする
wallfacer list [--project P] [--tag T] [--agent A] [--json]セッションをリスト表示(新着順)。--agent は大文字小文字を区別しない部分文字列を受け入れます
wallfacer search <query>タイトル、プロンプト、ディレクトリ、プロジェクト、タグを検索する
wallfacer show <ref>1つのセッションの詳細を表示する
wallfacer rename <ref> <title>セッションの名前を変更する
wallfacer tag add|rm <ref> <tag>…タグを追加または削除する
wallfacer project set|clear <ref>セッションをプロジェクトにグループ化する
wallfacer rm <ref> [--purge] [-f]セッションをゴミ箱に入れる(--purge は永久削除)
wallfacer syncディスクを再スキャンする(すべてのコマンドの前に自動実行)

<ref> はIDプレフィックス(resume 5f2)または完全なタイトル(resume "smoke test")です。曖昧な参照は推測せずに候補をリスト表示します。wallfacer以外で開始されたセッションは自動的に取り込まれます。インポート手順はありません。

仕組み

wallfacerは ~/.claude/projects/、~/.cursor/chats/、~/.kiro/sessions/cli/、および ~/.codex/sessions/ をスキャンし、各セッションファイルの先頭部分から作業ディレクトリ、タイムスタンプ、および最初のプロンプト(自動タイトル)を読み取ります。各エージェントのリストにはエージェントタイプが含まれるため、wallfacer list は AGENT 列を表示し、--agent は kiro や cursor のような大文字小文字を区別しない部分文字列で絞り込みます。あなたのメタデータは ~/.local/share/wallfacer/ のSQLiteに保存されます。これを削除しても、オーバーレイのみが失われ、会話が失われることはありません。同期は増分式なので、数百のセッションがあっても高速に保たれます。

rm はセッションをwallfacerのゴミ箱に移動します。1つのセッションが複数のファイルにまたがるエージェント(Kiro CLIはトランスクリプトとメタデータサイドカー、プロンプト履歴、スクラッチディレクトリを書き込み、Cursor CLIはチャットを独自のディレクトリとプロジェクトの下に保存されたトランスクリプトに分割します)の場合、セット全体が一緒に移動するため、削除されたセッションがエージェント自身のセッションピッカーに残ることはありません。

一度に1日、ブラウザはGitHubに新しいリリースが存在するかどうかを問い合わせ、存在する場合はフッターに一度だけ表示します。サブコマンドは、そのキャッシュされた回答を標準エラー出力に繰り返します。そのため、--json 出力やパイプラインに表示されることはありません。何もそれを待ちません。ルックアップはブラウザに属します。なぜなら、ブラウザはネットワークラウンドトリップよりも長く存続するフロントエンドだからです。サブコマンドはキャッシュされた回答を読むだけです(ファイル読み取り、ネットワークなし)。そのため、遅れて着弾したアップデートは、次にwallfacerを実行したときに表示されます。キャッシュはデータディレクトリにあり、WALLFACER_NO_UPDATE_CHECK=1 で全体を無効にできます。

他のエージェントは、小さなアダプターインターフェースを通じてプラグインできます。詳細はdocs/adding-an-agent.mdを参照してください。

ロードマップ

  • Claude Code、Cursor CLI、Kiro CLI、およびCodexのアダプター
  • opencodeのアダプター
  • 好みのエージェント設定。これにより、ピッカーのデフォルトを自分で選択できます
  • セッション コンテンツ 全体のフルテキスト検索(SQLite FTS5)
  • wallfacer restore (CLIからゴミ箱を復元)
  • セッショントランスクリプトをMarkdownにエクスポート
  • 統計情報(プロジェクトごと/週ごとのセッション数、ディスク使用量)
  • デスクトップアプリ — サイドバーにセッション、埋め込みターミナル、複数のタブ(Wails + xterm.js、同じGo内部構造の上に構築)

貢献

ビルド、テスト、リリースについては、開発ガイドを参照してください。貢献を歓迎します — 特に新しいエージェントアダプター。

ライセンス

MIT


この名前は、劉慈欣の『三体II:黒暗森林』に登場する「ウォールフェイサー」から借用しました。それは、誰にとってもあまりにも広範すぎる計画を託された人々です。