agent-sessions 用于跨多个 AI 编程代理检索和管理对话历史，覆盖 Claude Code、Codex CLI、Gemini CLI、opencode、Hermes Agent 和 Cline CLI。核心是位于 /Users/vladmdgolam/Play/radar/tools/agent-sessions 的 Python 3 脚本，读取各代理的会话数据。
主要能力：列出最近会话（默认30条）；按代理过滤，如 --agent claude、--agent codex、--agent gemini、--agent opencode、--agent hermes、--agent cline；按项目名或路径过滤 --project；先搜索标题或提示 --search "metal shader" --search-scope titles，未命中再用 --search-scope full 做完整转录搜索；输出紧凑 JSON（--json），默认省略 search_text，需要时才加 --include-search-text；生成可粘贴的会话上下文 --context <session-id>；生成证据包 --pack <id...> --max-chars；读取有界摘录 --read <id...> --query "logo rotation" --max-chars，并用 --role user 只提取用户消息。Claude Code 会话可用 --resume <session-id> 恢复。
数据来源包括 Claude Code 的 ~/.claude/projects/<encoded>/*.jsonl、Codex 的 SQLite 数据库与旧版 rollout JSONL、Gemini CLI 的 JSON 会话文件、opencode 的 opencode.db、Hermes Agent 的 state.db，以及 Cline CLI 的 sessions.db 与消息 JSON。
配套工具：Rust 模糊搜索 TUI claude-history（仅限 Claude Code，支持 --local、--resume、--fork-session），以及 GUI 桌面应用 Claude Code History Viewer（CCHV），支持 7 种代理、分析与成本追踪。
使用限制：优先使用小 limit 和标题搜索以节省 token；避免手工遍历文件系统或直接查询数据库；Claude 以外的代理不支持 --resume；部分路径为使用者本机绝对路径。具体安装方式与收费情况暂未提供。