Repository navigation
[FEATURE]: Add a directory tree to the V2 TUI #52109
Description
- I have verified this feature hasn't been suggested before.
The OpenCode V2 terminal UI currently does not provide a directory tree or file browser for the active workspace. Users have to leave the TUI or use a separate shell/file manager to inspect the project structure and open a path.
Please add an optional, collapsible directory tree to the V2 TUI. It should let users expand and collapse folders, open a selected file or directory with the system default application, and refresh when the workspace changes externally.
This request is specifically for the V2 terminal UI; it is not about the web or desktop file tree.
Metadata
Metadata
Assignees
Labels
No labels
Activity
github-actions commentedon Sep 29, 2026
For keybind-related issues, please also check our pinned keybinds documentation: #4997
[-][FEATURE]: Add opencode-dir-tree-tui to the ecosystem plugins[/-][+][FEATURE]: Add a directory tree to the V2 TUI[/+]opencodejr commentedon Oct 28, 2026
Thanks for the suggestion, @aihaipeng! You're asking for an optional, collapsible directory tree in the V2 TUI that lets you expand and collapse folders, open the selected file or directory with your system's default app, and refreshes when the workspace changes outside OpenCode. That would save you switching to a separate shell or file manager.
At the moment the V2 TUI's only file tree is the one in the diff viewer, and it lists only changed files. There's no general workspace browser. The maintainers will consider this.
In the meantime, it may be possible to build this as a TUI plugin. The plugin API lets a plugin add UI to the session sidebar (the
sidebar.contentslot) or open a side panel (thesession.panelslot), and register keybinds. The plugin would need to read the filesystem and call the system opener itself.