baoyudu/perch

これは何？

主な機能

• 01既存のClaude CodeとCodexのセッション履歴を設定なしで読み取ります。
• 02プロジェクトを名前やパスであいまい検索できます。
• 031回のキー入力で、cd、claudeまたはcodexの起動、直近のセッションの再開を行えます。
• 04各プロジェクトの最終使用エージェント、gitブランチ、変更のあるファイル数を表示します。
• 05直近の会話の末尾をプレビューできます。
• 06プロジェクトを固定し、TOMLでプロジェクトごとのデフォルト動作や引数を設定できます。

ユースケース

• コーディングエージェントを使う複数のリポジトリを行き来する。
• 新しいターミナルを開いたあと、昨日のClaude CodeやCodexの会話を再開する。
• 1回のキー入力で、指定したプロジェクト内のエージェントをカスタムフラグ付きで起動する。

クイックスタート

1. 1

   Homebrew で perch をインストール（macOS）

   brew install --cask baoyudu/tap/perch
2. 2

   または Go でソースからインストール

   go install github.com/baoyudu/perch/cmd/perch@latest
3. 3

   shell の rc ファイルに shell integration の行を追加（例は zsh）

   eval "$(perch init zsh)"
4. 4

   新しいターミナルを開き、p と入力して picker を起動

使う前に知っておきたいこと

• !プロジェクトの一覧表示には、ディスクに保存された Claude Code と Codex のセッション履歴が必要です。
• !Nerd Font アイコンなど一部の機能には、パッチ適用済みのターミナルフォントが必要です。プレーンモードも利用できます。

収録されている特集

トピック

よくある質問

perch とは？

Claude CodeやCodexで最近使ったプロジェクトに戻れるターミナルピッカー。エージェントの再起動や直近のセッション再開にも対応します。 perchは、Claude CodeやCodexで最後に作業していたプロジェクトに戻るためのGo製ターミナルツールです。両エージェントがディスクに保存するセッション履歴を読み取るため、設定は不要です。インストールすると、エージェントを使ったことのあるプロジェクトがすべて、あいまい検索できる一覧に表示されます。

perch は無料で使えますか？ライセンスは？

perch は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

perch は今もメンテナンスされていますか？

半年以内に更新あり。perch の最終コミットは 2026年9月14日 です。

perch は何に使えますか？

コーディングエージェントを使う複数のリポジトリを行き来する。 新しいターミナルを開いたあと、昨日のClaude CodeやCodexの会話を再開する。 1回のキー入力で、指定したプロジェクト内のエージェントをカスタムフラグ付きで起動する。

perch のインストール方法は？

Homebrew で perch をインストール（macOS）: brew install --cask baoyudu/tap/perch または Go でソースからインストール: go install github.com/baoyudu/perch/cmd/perch@latest shell の rc ファイルに shell integration の行を追加（例は zsh）: eval "$(perch init zsh)" 新しいターミナルを開き、p と入力して picker を起動

perch はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/baoyudu/perch