session-tool

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

session-tool (OpenCode + Claude Code Sessions)

session-tool (OpenCode + Claude Code 会话)

Session browser for OpenCode + Claude Code — list, read, and search session history. Part of @blogic-cz/agent-tools.
OpenCode + Claude Code 的会话浏览器,可列出、读取和搜索会话历史。是@blogic-cz/agent-tools的一部分。

How to Run

运行方式

Run via
bun session-tool
(requires
@blogic-cz/agent-tools
as a dev dependency). Auth: no auth needed — reads local session storage.
通过
bun session-tool
运行(需要将
@blogic-cz/agent-tools
作为开发依赖)。 鉴权:无需鉴权——直接读取本地会话存储。

Commands

命令

bash
bun session-tool list                   # List recent sessions
bun session-tool read --session <session-id> # Read session messages
bun session-tool search "query"         # Search across sessions
Session ID routing:
  • UUID format (
    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    ) -> Claude Code sessions
  • ses_*
    format -> OpenCode sessions
  • Other IDs -> searched across both sources
bash
bun session-tool list                   # List recent sessions
bun session-tool read --session <session-id> # Read session messages
bun session-tool search "query"         # Search across sessions
会话ID路由规则:
  • UUID格式(
    xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    )-> Claude Code 会话
  • ses_*
    格式 -> OpenCode 会话
  • 其他ID -> 同时在两个来源中搜索

Tips

提示

  • Use
    --help
    for full options.
  • Error responses include
    hint
    ,
    nextCommand
    , and
    retryable
    fields — always check them on failure.
  • 使用
    --help
    查看完整选项。
  • 错误响应包含
    hint
    nextCommand
    retryable
    字段——操作失败时请务必查看这些字段。