| name | pickbrain |
| description | Semantic search over past Pi, Claude Code, Codex, and Slack conversations, memories, and authored files. Use when the user wants to recall, find, or reference something from a previous coding-agent session or Slack conversation — e.g. "what did we discuss about X", "find that conversation where we fixed Y", "search my history for Z", "what did someone say about X in Slack". |
| allowed-tools | Bash |
Pickbrain — Semantic Search for Claude History and Slack
Search past Pi sessions, Claude Code conversations, Codex sessions, Slack messages, memory files, and authored files using semantic search.
Installation
Build and install from the repo root:
make pickbrain
ln -sf "$(pwd)/pickbrain" ~/bin/pickbrain
The binary embeds its own model weights (embed-assets feature), so no separate assets directory is needed.
Usage
Run pickbrain via Bash with the user's query:
pickbrain "$ARGUMENTS"
Pickbrain automatically ingests new Pi/Claude/Codex sessions, Slack conversations (from the desktop app's local IndexedDB), memories, and project config files before each search.
Interpreting Results
Each result includes:
- Timestamp and project directory (or channel name for Slack results)
- Source —
pi, claude, codex, or slack
- Session ID and turn number (Claude/Codex) or channel + thread ID (Slack)
- Matching text — the relevant chunk from the conversation
Slack results show thr:TIMESTAMP for threaded conversations. This thread ID can be passed to --session or --dump to filter/view that thread.
Present results as a concise summary. Quote the most relevant excerpts. If the user wants to dig deeper into a specific session, use --dump:
pickbrain --dump <session-id> [--turns <start>-<end>]
pickbrain --dump <channel-name> [--turns <start>-<end>] [--since 7d]
pickbrain --dump thr:<thread-ts>
Slack results include (you: Name (@handle)) to identify the logged-in user.
Filtering
To search within the current (calling) session:
pickbrain --current "<query>"
To search within a specific session, channel, or thread:
pickbrain --session <session-id> "<query>"
pickbrain --channel <channel-name> "<query>"
pickbrain --session thr:<thread-ts> "<query>"
--channel is an alias for --session.
To exclude the current (calling) session from results:
pickbrain --exclude-current "<query>"
To filter by git branch:
pickbrain --branch <branch-name> "<query>"
pickbrain --branch . "<query>"
To exclude specific sessions from results (comma-separated or repeated):
pickbrain --exclude <uuid1>,<uuid2> "<query>"
pickbrain --exclude <uuid1> --exclude <uuid2> "<query>"
To search only recent history:
pickbrain --since 24h "<query>"
pickbrain --since 7d "<query>"
pickbrain --since 2w "<query>"
To filter by source type (pi, claude, codex, slack):
pickbrain --type slack "<query>"
pickbrain --type claude,codex "<query>"
To filter Slack results by DM or non-DM:
pickbrain --dm "<query>"
pickbrain --no-dm "<query>"
To show only Slack conversations with unread messages:
pickbrain --unread "<query>"
To control the number of results (0 = unlimited; default: unlimited in TUI, 20 in pipe):
pickbrain -n 50 "<query>"
pickbrain -n 0 "<query>"
When any filter is active (--type, --session, --channel, --dm, --no-dm, --unread, --since), the query can be omitted to browse matching results sorted by date:
pickbrain --type slack --unread
pickbrain --channel general --since 7d
pickbrain --dm --since 24h
Notes
- First run requires a full ingest+embed pass (~7s). Subsequent searches auto-ingest incrementally.
- The database lives at
~/.pickbrain/pickbrain.db.
- Results are ranked by semantic similarity — they may not contain the exact query words.
- The active session's JSONL is skipped during ingest if it was indexed less than 10 minutes ago. If the active session can't be detected (e.g. on Windows), everything is ingested eagerly.
