find-my-session

Name: find-my-session
Author: SomeNoneAI

ローカル

github.com/SomeNoneAI検索14 日前に更新

リポジトリ

find-my-session について

find-my-sessionは、コーディングエージェント向けのローカル読み取り専用セッション検索ツールです。CLI、エージェントスキル、ブラウザUIを備え、対応するハーネスを横断してセッションを検索し、全文の代わりに簡潔な引き継ぎ要約を作成します。

主な機能

01コーディングエージェントハーネス横断検索
02簡潔なセッション引き継ぎ要約
03ユーザープロンプトのページ表示
04ハーネスコマンドによるセッション再開
05記録済みトークンとコストの集計
06読み取り専用ブラウザパネル

活用シーン

01利用枠切れ後の過去セッション検索
02別のハーネスのセッションから作業を継続
03プロジェクトセッションのプロンプト確認
04ハーネスごとの記録済み使用量の確認

MCP 対応

`fms mcp`コマンドはstdioでMCPサーバーを実行し、読み取り専用の検索、表示、プロンプト、統計、診断ツールを公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "somenoneai-find-my-session": {
      "command": "uvx",
      "args": [
        "find-my-session"
      ]
    }
  }
}

起動コマンドuvx find-my-session

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypifind-my-session0.1.4stdio

ツール

掲載時のツール一覧 · 3 日前に更新

このツールにパラメーターはありません。

詳細

find-my-session

🌐 中文说明

コーディングエージェント向けの、ローカルで読み取り専用のセッション検索・引き継ぎツールです。1つの fms_lib コアを共有する、次の2つの形態で提供されます。

find-my-session-skill — エージェントスキル（fms CLI）です。複数のハーネスをまたいで適切なセッションを見つけ、トランスクリプト全体ではなく、少ないトークン数で済む引き継ぎ用ダイジェストを表示します。
find-my-session-ui — 同じストアを扱う、人にとって使いやすいブラウザーパネルです。

ハーネスのクォータが尽きたとき、何をしていたかは覚えていても、セッションがどこにあるかは思い出せないことがよくあります。fmsなら、1つの簡潔なコマンドでその問題を解決できます。

ターミナルでのfms searchとfms show

1つのセッションのユーザープロンプトをカウントしてページ分割する様子

合成セッションストアを読み込むfind-my-sessionのブラウザーパネル

スクリーンショットでは、合成フィクスチャデータを使用しています。

エージェントに依頼する

スキルがインストールされていれば、fmsのフラグを指定する必要はありません。自然な言葉でエージェントに話しかけるだけです。

/find-my-session 找到 claude-code 最近的一个会话，继续那个任务
/find-my-session find the most recent claude-code session and continue that task
/find-my-session 额度用完了，在 claude-code 里找昨天关于鉴权的那次会话并接力
/find-my-session search my claude-code sessions about token refresh and show the handoff digest
/find-my-session 列出这个项目最近一次 claude-code 会话里我提过的所有需求

エージェントがハーネスを特定し、search／latest／show／promptsを実行して、作業を続けます。

対応ハーネス

21種類のアダプターが利用可能で、さらに2種類が予定されています。検証済みのバージョン、インターフェース、注意事項は互換性マトリクスに、ハーネスごとのストアの詳細はreferences/に記載されています。

ハーネス	参照プレフィックス	ストア
Qoder CN	`qoder-cn`	`~/.qoder-cn`
Qoder (国際版)	`qoder`	`~/.qoder`
Kimi Code	`kimi-code`	`~/.kimi-code`
ZCode	`zcode`	`~/.zcode`
CodeArts Agent	`codearts-agent`	`~/.codeartsdoer`
ChatGPT Codex	`codex`	`~/.codex`
DeepSeek Harness	`deepseek`	`~/.dsh`
Claude Code	`claude-code`	`~/.claude`
Cline	`cline`	`~/.cline`
Grok Build	`grok-build`	`~/.grok`
WorkBuddy AI	`workbuddy`	`~/.workbuddy-ai`
WorkBuddy (中国国内版)	`workbuddy-cn`	`~/.workbuddy`
Antigravity	`antigravity`	`~/.gemini/antigravity`
Antigravity CLI	`antigravity-cli`	`~/.gemini/antigravity-cli`
MiniMax Code	`minimax-code`	`~/.minimax/v2`
Cursor	`cursor`	`~/.cursor/projects`
OpenCode	`opencode`	`~/.local/share/opencode`
Gemini CLI	`gemini-cli`	`~/.gemini`
Qwen Code	`qwen`	`~/.qwen`
Pi	`pi`	`~/.pi/agent/sessions`
Oh My Pi	`omp`	`~/.omp/agent/sessions`
CodeBuddy	予定（`codebuddy`）	`~/.codebuddy`
Cline (VS Code拡張機能)	予定（`cline-vscode`）	VS Code globalStorage

要件

Python 3.9以降、macOSまたはLinux。Python 3.9は上流でサポート終了しており、0.2では3.10以降を必須とする予定です（ROADMAP.mdを参照）。
サードパーティ製のPythonパッケージは不要です。
圧縮ストア（codex .jsonl.zst、deepseek .zstd）にはzstdデコーダーが必要です。Python 3.14以降、またはzstd CLIを使用してください。それ以外の場合、これらのセッションはスキップされます。
Windowsでは、実験的でブロッキングしないCIジョブによるテストを実施していますが、まだサポート対象ではありません。ROADMAP.mdを参照してください。

インストール

CLI と UI のコマンド

pipx install find-my-session を実行すると、PyPI から fms コマンドと fms-ui コマンドがインストールされます。未リリースのコミットを実行するには、Git からインストールします：pipx install git+https://github.com/SomeNoneAI/find-my-session.git。アップグレードするには pipx upgrade find-my-session、アンインストールするには pipx uninstall find-my-session を使用します。uv を使う場合、uvx --from find-my-session fms ... を実行すると、永続的にインストールせずに PyPI リリースを実行できます。

エージェント向け：スキル

リリース ZIP。 各 GitHub リリースで find-my-session-skill.zip が公開されます。最新リリースからダウンロードし、ハーネスにインストールします（たとえば、Claude Code では ~/.claude/skills に展開するか、ディレクトリをハーネスのスキルフォルダーにリンクします）。
ソースのチェックアウト。
```
git clone https://github.com/SomeNoneAI/find-my-session.git
cd find-my-session
ln -s "$PWD/skills/find-my-session" ~/.claude/skills/find-my-session   # Claude Code; adapt the path for your harness
```
チェックアウトから CLI を python3 skills/find-my-session/scripts/fms として直接実行することも、python3 tools/build_artifacts.py を実行して dist/find-my-session-skill.zip を自分でビルドすることもできます。リンクしたスキルを削除するには、ハーネスのスキルフォルダーからそのシンボリックリンクを削除します。

人間向け：UI パネル

リリース ZIP。 最新リリースから find-my-session-ui.zip をダウンロードして展開し、展開したディレクトリから python3 fms-ui を実行します（展開ツールが実行権限を保持する場合は ./fms-ui でも実行できます）。アップグレードするにはそのディレクトリを置き換え、アンインストールするには削除します。
pipx。 上記と同じ pipx インストールで fms-ui コマンドも利用できます。
ソースのチェックアウト。 fms_ui/fms-ui を実行します（ブラウザーを開かずにポートを指定するには --no-browser --port 8765 を使用します）。

パネルは 127.0.0.1 で読み取り専用サーバーを起動します。キーワードとメタデータによるフィルター、セッションの概要、ページ分割されたユーザープロンプト、最近のターン、コピー可能な参照を利用できます。静的フロントエンドは同一オリジンの JSON API のみを使用し、Node.js も外部アセットも必要ありません。言語はローカルシステムの設定に従い、zh/en の切り替えも明示的に行えます。インターフェースはシステムのライト／ダーク設定にも従い、手動切り替えと真っ黒ではないダークパレットも備えています。フロントエンドは Vue 3 + TypeScript + Vite で構築されています。Node.js が必要なのは fms_ui/frontend/ から開発するときのみで、パネルの実行には必要ありません。

クイックスタート

fms harnesses                                     # list ready and planned harnesses
fms search "quota handoff" --harness claude-code  # find sessions by keywords
fms latest --harness claude-code --cwd .          # most recent session in this repo
fms show claude-code:c1a0de01                     # low-token handoff digest
fms prompts claude-code:c1a0de01 --count          # count human prompts, then page with --limit/--offset
fms resume claude-code:e1a2b3c4 --exec            # jump straight back into a session
fms stats --since 7d                              # token/cost totals across harnesses

検索では明示的な --harness が優先されます。クエリを省略すると、最近のセッションが一覧表示されます。--include-archived を指定しない限り、アーカイブ済みのセッションは search／latest の対象から除外されます。show は読み取り専用で、ソースの生のパスを出力するため、ダイジェストだけでは不十分な場合にエージェントが元のファイルを grep できます。

コマンド

コマンド	目的
`fms harnesses`	利用可能なハーネスと予定されているハーネス、バリアント、ストアを一覧表示します。
`fms search [query ...]`	キーワードでセッションのメタデータを検索します。クエリを省略すると、最近のセッションが一覧表示されます。
`fms latest`	条件に一致する最新のセッションを返します。
`fms show <ref>`	1 つのセッションの引き継ぎ用ダイジェストを出力します。
`fms prompts <ref>`	1 つのセッションに含まれるすべての人間のプロンプトを一覧表示します。件数、ページ、順序を指定できます。
`fms mcp`	標準入出力で Model Context Protocol サーバーを実行します。MCP ネイティブのホスト向けに、読み取り専用の MCP ツールとして search/show/prompts/stats/doctor を公開します。docs/mcp.md を参照してください。
`fms stats [--harness] [--since] [--json]`	ハーネス自身が記録したトークン／コスト使用量を集計します。使用量が記録されていないハーネスは `-` と表示されます。
`fms resume <ref> [--exec]`	セッションを再度開くハーネスコマンドを出力（または実行）します。確認済みの再開コマンドがない場合は、引き継ぎ用ダイジェストにフォールバックします。
`fms doctor [--harness] [--json] [--fingerprint]`	ローカル環境とストアを確認します（デコーダーの利用可否、読み取り可能なルート、ハーネスごとの健全性）。`--fingerprint` を指定すると、ドリフトレポート用にコンテンツを含まない形状の概要を追加します。

便利なオプション

オプション	対象	意味
`--harness NAME[,NAME]`	search, latest, show, prompts, doctor	検索対象をハーネスに限定します。速度と精度を高めるために推奨します。
`--cwd PATH`	search, latest	作業ディレクトリが `PATH` を含む、または `PATH` に含まれるセッションを照合します。
`--since 7d` / `--since 2026-10-01`	search, latest	最終更新時刻で絞り込みます。
`--limit N`	search, latest, prompts	結果またはプロンプトの数を制限します。`0` は無制限を意味します。
`--offset N`	prompts	最初の N 件のプロンプトをスキップします。
`--order oldest/newest`	prompts	ページの順序です。元のインデックスは保持されます。
`--count`	prompts	プロンプトの合計数のみを出力します。
`--deep`	search, latest	トランスクリプト全体もスキャンします。時間はかかりますが、メタデータのみを出力します。
`--include-archived`	search, latest	アーカイブ済みのセッションを含めます。デフォルトでは無効です。
`--verbose`	search, latest	標準出力を変更せず、スキップされたセッションについて標準エラー出力に警告します。
`--messages N` / `--chars N` / `--summary-chars N`	show	ターン数、メッセージごとの文字数、要約の文字数を制限します。
`--json`	harnesses, search, latest, prompts, doctor	機械可読な出力です。`show` では `--format json` を使用します。フィールドの仕様については、docs/json-output.md を参照してください。

セッション参照には harness:session-prefix を使用します（例：claude-code:c1a0de01）。対応するストアの生のトランスクリプトパスも使用できます。

fzf で選択する

すべての一覧はプレーンな TSV 形式なので、パイプを使って対話的に選択できます。

fms search --limit 0 | fzf | cut -f1 | xargs -I{} fms show {}
fms search --limit 0 --include-archived | fzf --with-nth=2,4 | cut -f1 | xargs -I{} fms resume {}

2 つ目のレシピでは、ハーネスに検証済みの再開コマンドがある場合、選択したセッションをそのハーネスで再開します（fms resume --help を参照）。1 つのストアを共有するデスクトップ／CLI の各インターフェースでは、参照領域も共有されます。どのインターフェースが検証済みかについては、互換性マトリックスを参照してください。

プライバシーと安全性

すべての処理はローカルで実行されます。CLI はネットワークリクエストを行いません。
CLI はセッションファイルとデータベースのみを読み取り、SQLite ストアは読み取り専用で開きます。セッションの内容を編集または削除することはありません。
検索結果にはメタデータのみが含まれます。show と prompts は会話の内容を出力する場合があるため、その出力は元のトランスクリプトと同様に取り扱ってください。

開発とドキュメント

CONTRIBUTING.md — セットアップ、テスト、ハーネスの追加または検証方法です。
docs/compatibility.md — ハーネスごとの詳細な互換性マトリックスです。
docs/json-output.md — --json のフィールド仕様と、1.0 より前の安定性ポリシーです。
docs/faq.md — 5 分間のチュートリアルと、「セッションはどこにありますか」というよくある質問への回答です。
ROADMAP.md — 近い将来の計画です。
SECURITY.md — サポート対象のバージョンと、非公開での脆弱性報告についてです。
skills/find-my-session/references/ — ハーネスごとのストアスキーマと検証レシピです。ハーネスを追加するには、extending.md から始めてください。

python3 -m unittest discover -s tests -v
python3 -m compileall -q core fms_ui skills/find-my-session/scripts tools tests
python3 tools/build_artifacts.py   # rebuild dist/find-my-session-skill(.zip) and dist/find-my-session-ui(.zip)

ライセンス

MIT。LICENSE を参照してください。

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

find-my-session

find-my-session について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

find-my-session

エージェントに依頼する

対応ハーネス

要件

インストール

CLI と UI のコマンド

エージェント向け：スキル

人間向け：UI パネル

クイックスタート

コマンド

便利なオプション

fzf で選択する

プライバシーと安全性

開発とドキュメント

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？