Repository navigation
Releases
v1.2.0 — reveal in tree, position memory, collapsible tree
Reveal a file in the tree, remember where you were, and get the tree out of the way.
- Reveal in the file tree — right click an open tab (or press
F10with the
editor focused) and pick Reveal in the file tree. Expand mode expands the
folders and selects the file; navigate mode enters its folder. Dotfiles get
un-hidden and a hidden tree comes back. - Position memory — scroll and cursor line/column survive
F4toggles and
tab switches. The preview status showsLn X/Y. - Collapsible tree —
F6or the«in the explorer header hides the tree,
leaving a narrow»strip to click it back. Shortcuts stay in the footer. - Wrap and gutters — wrapping hides the line numbers in the preview too, and
turning it off restores them. Horizontal scrollbar in the viewer and editor.
opencode plugin add opencode-file-browser@latestTests: 32 + 32 end-to-end assertions in a real TUI, 8 navigation unit tests.
v1.1.0 — context menus, copy/move and horizontal scrolling
Context menus, file copy/move and horizontal scrolling.
- Right click the empty area of the explorer: new file, new folder and paste.
- Copy / Move to… from a file or folder menu. Move opens a folder picker
with a.. (up)row, navigable by keyboard and mouse. - Navigate mode: clicking a folder now opens it (before it toggled a tree
state that does not exist in that mode) and the chevron no longer lies. - Footer shortcuts are always visible; transient messages moved to their own
line and clear after six seconds. - Preferences: two-line rows and a wider dialog, so descriptions are no
longer truncated with…. - Wrap hides the line numbers in the viewer too, and a horizontal
scrollbar appears when wrapping is off (viewer native, editor click-to-jump).
opencode plugin add opencode-file-browser@latestTests: 32 + 22 end-to-end assertions in a real TUI.
v1.0.3 — no dead ends in navigate mode
Fixes the dead end in navigate mode (Folders → navigate):
Shift+Enter(collapse) now returns to the project root instead of clearing
an invisible tree state and appearing to do nothing.- Navigate listings start with a clickable
↰ ..row; the path in the header
also goes up on click. - A folder that fails to load keeps the previous listing instead of an empty
screen, and an empty folder explains how to leave. - Navigation rules moved to
src/lib/navigation.tswith 8 unit tests that run
in CI before publishing, plus an end-to-end navigate scenario.
opencode plugin add opencode-file-browser@latestv1.0.2 — install without the dev toolchain
Install fix.
The first public build shipped its build toolchain in devDependencies. OpenCode
installs plugins with npm install --include=dev, so a cold install downloaded
TypeScript, Babel and the whole OpenTUI tree and the prepare step stalled past
the TUI startup budget.
prepackremovesdevDependenciesfrom the packed manifest,postpack
restores the working copy; the repo keeps the full toolchain.- The published tarball has no
devDependencies(20 files, ~66 kB).
opencode plugin add opencode-file-browser@latestv1.0.0 — explorer, editor and git in the TUI
Explorer, editor and git panel for the OpenCode TUI, in one plugin.
Highlights
- Explorer — expand folders in place or navigate into them, name/content
search (case-sensitive option), hidden files, branch and change count. - Editor — tabs, line numbers, syntax colours while editing,
Enterfor a
new line,Ctrl+Finside the file,Ctrl+S, scrollbar and click-to-place
cursor. - Changes — stage, unstage, discard, commit, pull, push, branches and
history;Enteropens a unified diff,F4jumps to the file. - Preferences —
F2modal with simple mode, line numbers, wrap, folder
behaviour, panel preview, changes panel, hidden files, mouse, search target
and confirmations. - Context menu — right click or
F10: new file/folder, rename, delete,
close this/other/all tabs. - Safe with huge files — 2 000 rendered lines; above 20 000 lines or 2 MiB
a metadata placeholder keeps the TUI responsive.
Install
opencode plugin add opencode-file-browser@latestRestart OpenCode (or /reload).
Tests
Two end-to-end suites drive a real TUI in tmux against a git fixture:
test/e2e.sh (32 assertions) and test/e2e-extra.sh (11 assertions), both
green on OpenCode 2.2.5.
Project page: https://arthurrogado.github.io/opencode-file-browser/
v0.3.2
Fix Markdown heading styles.
- Register
markup.heading.1through.6in the SyntaxStyle. OpenTUI resolves dotted scopes only to the first segment, so H1 and H4-H6 previously fell back to the unregisteredmarkupscope. - Includes the v0.3.0 self-update command and the v0.2.1 SyntaxStyle lifecycle fix.
- README screenshots for the Markdown and Python previews are on main (docs/screenshots).
Install:
opencode plugin add opencode-file-browserv0.3.1
Documentation release: the npm package is now the recommended install.
opencode plugin add opencode-file-browser- update with
opencode plugin update opencode-file-browser - clone install remains available for offline/edge cases
- includes the v0.3.0 self-update command and the v0.2.1 SyntaxStyle fix
TUI-only plugin for OpenCode V2.
v0.3.0
Adds a self-update command.
- Run
/files-update(or the palette command Update file browser) to pull the latest checkout and let the TUI reload it. - Includes the v0.2.1 fix for
NativeSyntaxStyle is destroyed. - TUI-only plugin for OpenCode V2.
Install:
git clone https://github.com/arthurrogado/opencode-file-browser ~/.config/opencode/plugins/file-browserv0.2.1
Fixes a crash when opening Markdown or code after the first render.
- Keep the OpenTUI
SyntaxStylealive for the component lifetime; it is now destroyed only on cleanup. Previouslyrenderer.idle()resolved after the next frame and destroyed the style while the viewer was still using it (Could not render this file: NativeSyntaxStyle is destroyed). - Rename the build script to
bundleto avoid npm Git-dependency preparation on install. dist/tui.jsis prebuilt; nothing compiles on install.
Install:
git clone https://github.com/arthurrogado/opencode-file-browser ~/.config/opencode/plugins/file-browserv0.2.0
Superseded by v0.2.1, which fixes a crash when opening Markdown or code after the first render (NativeSyntaxStyle is destroyed). Use v0.2.1.
- Browse folders in a session side panel or as a full-page route.
- Preview Markdown rendered; press m to switch to the source.
- Read code with tree-sitter highlighting.
- Open any file by path (
oin the browser, orCtrl+XthenOglobally). - Toggle full screen with
fto hide the chat. - TUI-only plugin for OpenCode V2.
Install:
git clone https://github.com/arthurrogado/opencode-file-browser ~/.config/opencode/plugins/file-browser