sessions 是 ferueda/harness 技能附带的本地 CLI，用途是浏览和分析本地 Cursor 或 Codex 的智能体会话历史，支持对话记录查找、工作流与技能使用审计。
主要能力：可用 sessions analyze 配合 --provider cursor|codex、--include-turns、--extract-only 提取对话片段、产物与来源信息。支持按天数（--days）、工作区（--workspace）、精确会话 ID（--session-id）、模糊元数据（--query，匹配标题、id、工作区或首个用户提问）及可重复的 --turn-query（检索用户轮次文本，多个词为 OR 语义，matchedQueries 记录命中词）缩小范围。可输出表格或 JSON（--format json），并用 --evidence-limit 控制表格行数。附带 sessions cursor show / codex show 查看完整会话。
安装与用法：需 Node >=24 及 pnpm 或 Corepack；在技能根目录执行 ./scripts/install.sh，或以 pnpm install --ignore-workspace --prod --frozen-lockfile 手动安装并软链到 ~/.local/bin；也可直接 node scripts/sessions.ts --help。索引缓存默认位于 ~/.sessions/index，可用 SESSIONS_CACHE_DIR 覆盖。分析前建议先 reindex。
限制与注意：--query 只做元数据发现，不搜索全部轮次；--turn-query 仅覆盖用户轮次，助手与工具轮次需用 show 或 export。不加过滤条件运行 --include-turns 会扫描所有缓存并告警。建议先看表格再定向打开结果，注意隐私，不引用密钥或私密文本，输出中的模式只作重复提示而非重要性判断。