# Use CLI Recall

> recall CLI 経由で過去の Claude Code/Codex セッションを検索する。

- Skill: `thkt/use-cli-recall-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add thkt/use-cli-recall-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thkt/use-cli-recall-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: thkt (https://skillmd.com/u/thkt)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/thkt/use-cli-recall-2

---


# use-cli-recall

## 使いどころ

該当したら検討せず呼び出す。過去の判断は recall、現在のコード状態は `ugrep`/`bfs` が答えるので、コード検索の欄があるトリガーでは両方を並列に走らせる。

| トリガー           | シグナル                                    | 同時に走らせるコード検索   |
| ------------------ | ------------------------------------------- | -------------------------- |
| 時間的参照         | 「前に」「あの時」過去の出来事 / 判断       | -                          |
| 構造的エコー       | 現在の問題が過去の状況と似ている            | 現在の類似コード           |
| 繰り返し           | 「また同じ」反復ミス                        | -                          |
| 曖昧な後方参照     | 「あの件」具体性のない過去の作業            | -                          |
| モジュール初回接触 | このセッションでファイル / モジュール初編集 | モジュール名、主要な識別子 |

## コマンド

モジュール初回接触では `--file` を使う。そのファイルを触ったセッションだけに絞れるので、モジュール名での全文検索より当たりが正確になる。

| 目的                 | コマンド                                                        |
| -------------------- | --------------------------------------------------------------- |
| 検索                 | `recall search "query"`。短縮形は `recall "query"`              |
| 直近 N 日            | `recall search "query" --days N`                                |
| プロジェクトフィルタ | `recall search "query" --project <path>`                        |
| ファイルフィルタ     | `recall search "query" --file <path>`                           |
| ソースフィルタ       | `recall search "query" --source claude` または `--source codex` |
| 結果数制限           | `recall search "query" --limit N`。デフォルト 10、最大 100      |
| セッション表示       | `recall show <session-id>`                                      |
| ステータス           | `recall status`                                                 |
| 増分インデックス     | `recall index`                                                  |
| 完全リビルド         | `recall rebuild`                                                |

## 落とし穴

最初から二言語クエリを書く (例 `recall "認証 auth"`)。FTS5 の trigram トークナイズは 2 文字以下の日本語語句にマッチせず、認証や依存は 0 件になる。embedding は EN⇄JA を橋渡ししない (thkt/recall#51)。両言語を含めることで各検索経路をカバーする。

recall はクエリを拡張しない (caller-is-LLM, thkt/recall#25)。ハイブリッド検索は最近傍を返すため、貧弱なクエリは 0 件ではなく低関連の結果になる。結果が空または低関連のときは、同義語、EN⇄JA バリアント、関連概念語を使ってクエリを書き直し、1 回リトライする。

## 正典は help 出力

オプション、フィルタ、exit code は `recall --help` と `recall <subcommand> --help` にある。help と記憶が食い違えば help が正しい。