justcyl pi-threads
搜索和阅读历史 pi coding agent 会话的 CLI 工具。将 ~/.pi/agent/sessions/ 中的 JSONL 会话文件索引到本地 SQLite FTS5 数据库，提供快速搜索、模糊定位和清洁阅读。
前置检查
command -v pi-threads || echo "NOT INSTALLED — see /Users/chenyl/project/pi-threads/README.md"
第一步：确保索引是最新的
pi-threads --json sync
增量同步，只处理有变化的文件。首次约 1-2 秒。
核心工作流
1. 搜索消息
跨所有会话全文搜索：
pi-threads --json messages search "build a CLI" --limit 10
pi-threads --json messages search "pytest" --role user --project ph2
2. 模糊定位线程
当你知道大概内容但不知道 session ID 时：
pi-threads --json threads resolve "paper format check"
pi-threads --json threads resolve "skill creation"
3. 阅读线程
获取清洁的 user + assistant 消息（已移除 tool noise）：
pi-threads --json threads read <session-id-or-prefix>
支持部分 ID：pi-threads --json threads read 69107ac3
4. 查看原始事件
需要完整上下文（包括 tool 调用和结果）时：
pi-threads --json events read <session-id> --limit 50
5. 列出线程
pi-threads --json threads list --limit 10
pi-threads --json threads list --project sttrl
典型场景：从线程提取 skill
# 1. 搜索关键词找到相关线程
pi-threads --json messages search "overleaf review" --limit 5
# 2. 阅读找到的线程
pi-threads --json threads read <session-id>
# 3. 从对话中提取 pattern，写成 skill
输出格式
所有 --json 输出使用标准信封，包含 result、metadata、next_actions。
注意
- 首次使用前需要
pi-threads --json sync - 搜索默认使用 FTS5 全文检索，也支持
--match-mode contains和--match-mode exact - 不需要网络，纯本地操作