OpenCode Session Explorer
English | 中文
English
Browse, search, continue, export, and manage project OpenCode sessions from the VSCode Activity Bar.
Features
- Adds an
OpenCode Sessions icon to the left Activity Bar.
- Groups sessions by the folders currently opened in the VSCode window.
- Sub-groups by directory, date, agent, or model for the current VSCode window.
- Includes sessions created in the opened folder or any child directory.
- Search sessions by title, id, directory, model, or agent.
- Filter sessions by updated time and group results by date.
- Show session details in a rich Webview panel with cards for metadata, model, usage, and changes.
- Mark sessions as favorites and keep them pinned above other sessions.
- Add custom tags to sessions with color-coded labels.
- Rename sessions directly from the context menu.
- Archive or unarchive sessions to keep the list clean.
- Click a session to open it with the same terminal protocol used by the official OpenCode VSCode extension.
- Fork a session to start a new branch from an existing context.
- Delete sessions from the session context menu.
- Bulk delete old sessions or clean empty/stale sessions with a candidate list confirmation.
- Export one session or all sessions in a workspace folder to Markdown or JSON (with optional sanitization).
- Session timestamps are formatted with the user's local timezone.
- Uses
opencode db ... --format json instead of native SQLite dependencies.
- Auto-refresh at a configurable interval.
Configuration
| Setting |
Default |
Description |
opencodeSessionExplorer.cliPath |
opencode |
OpenCode CLI executable path. The extension auto-detects common nvm, npm, pnpm, bun, Homebrew, mise, and asdf installs when the VSCode extension host cannot find opencode on PATH. |
opencodeSessionExplorer.maxSessionsPerFolder |
100 |
Maximum sessions shown for each opened folder. |
opencodeSessionExplorer.includeArchived |
false |
Show archived sessions. |
opencodeSessionExplorer.autoRefreshInterval |
0 |
Auto-refresh interval in seconds. 0 disables auto-refresh. |
If auto-detection fails, set opencodeSessionExplorer.cliPath to the full executable path, such as opencode.exe on Windows or /opt/homebrew/bin/opencode on macOS.
Development
npm install
npm run compile
Press F5 in VSCode to launch the Extension Development Host.
中文说明
从 VSCode 左侧 Activity Bar 浏览、搜索、继续、导出和管理当前项目的 OpenCode 会话。
功能
- 在左侧 Activity Bar 增加
OpenCode Sessions 入口。
- 按当前 VSCode 窗口打开的文件夹分组展示会话。
- 支持在当前 VSCode 窗口内按目录、日期、agent 或模型二级分组。
- 包含在已打开文件夹及其子目录中创建的会话。
- 支持按标题、ID、目录、模型或 agent 搜索会话。
- 支持按更新时间筛选，并按日期分组展示结果。
- 在 Webview 详情面板中卡片式展示会话元数据、模型、用量和变更。
- 支持收藏会话，并将收藏会话固定在其他会话上方。
- 支持给会话添加自定义标签，带颜色标识。
- 支持右键直接重命名会话。
- 支持归档/取消归档会话，保持列表整洁。
- 点击会话可使用官方 OpenCode VSCode 扩展同款终端协议打开。
- 支持从已有会话 Fork 新分支任务。
- 支持通过会话右键菜单删除会话。
- 批量删除旧会话，或通过候选列表确认清理空/过期会话。
- 支持将单个会话或工作区文件夹下的全部会话导出为 Markdown 或 JSON（支持脱敏导出）。
- 会话时间按用户本地时区格式化。
- 通过
opencode db ... --format json 读取数据，不引入原生 SQLite 依赖。
- 支持可配置间隔的自动刷新。
配置
| 配置项 |
默认值 |
说明 |
opencodeSessionExplorer.cliPath |
opencode |
OpenCode CLI 可执行文件路径。当 VSCode 扩展宿主无法从 PATH 找到 opencode 时，会自动检测常见的 nvm、npm、pnpm、bun、Homebrew、mise 和 asdf 安装位置。 |
opencodeSessionExplorer.maxSessionsPerFolder |
100 |
每个已打开文件夹最多展示的会话数量。 |
opencodeSessionExplorer.includeArchived |
false |
是否在列表中展示已归档会话。 |
opencodeSessionExplorer.autoRefreshInterval |
0 |
自动刷新间隔（秒），设为 0 关闭。 |
如果自动检测失败，请将 opencodeSessionExplorer.cliPath 设置为完整可执行文件路径，例如 Windows 上的 opencode.exe，或 macOS 上的 /opt/homebrew/bin/opencode。
开发
npm install
npm run compile
在 VSCode 中按 F5 启动 Extension Development Host。
