Skip to content

Releases

v1.2.0 — reveal in tree, position memory, collapsible tree

Choose a tag to compare

@arthurrogado arthurrogado released this 14 Nov 02:26

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 F10 with 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 F4 toggles and
    tab switches. The preview status shows Ln X/Y.
  • Collapsible tree — F6 or 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@latest

Tests: 32 + 32 end-to-end assertions in a real TUI, 8 navigation unit tests.

v1.1.0 — context menus, copy/move and horizontal scrolling

Choose a tag to compare

@arthurrogado arthurrogado released this 13 Nov 15:22

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@latest

Tests: 32 + 22 end-to-end assertions in a real TUI.

v1.0.3 — no dead ends in navigate mode

Choose a tag to compare

@arthurrogado arthurrogado released this 13 Nov 03:10

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.ts with 8 unit tests that run
    in CI before publishing, plus an end-to-end navigate scenario.
opencode plugin add opencode-file-browser@latest

v1.0.2 — install without the dev toolchain

Choose a tag to compare

@arthurrogado arthurrogado released this 12 Nov 13:28

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.

  • prepack removes devDependencies from 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@latest

v1.0.0 — explorer, editor and git in the TUI

Choose a tag to compare

@arthurrogado arthurrogado released this 12 Nov 04:04

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, Enter for a
    new line, Ctrl+F inside the file, Ctrl+S, scrollbar and click-to-place
    cursor.
  • Changes — stage, unstage, discard, commit, pull, push, branches and
    history; Enter opens a unified diff, F4 jumps to the file.
  • Preferences — F2 modal 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@latest

Restart 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

Choose a tag to compare

@arthurrogado arthurrogado released this 09 Nov 03:01

Fix Markdown heading styles.

  • Register markup.heading.1 through .6 in the SyntaxStyle. OpenTUI resolves dotted scopes only to the first segment, so H1 and H4-H6 previously fell back to the unregistered markup scope.
  • 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-browser

v0.3.1

Choose a tag to compare

@arthurrogado arthurrogado released this 08 Nov 14:54

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

Choose a tag to compare

@arthurrogado arthurrogado released this 08 Nov 14:42

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-browser

v0.2.1

Choose a tag to compare

@arthurrogado arthurrogado released this 08 Nov 14:40

Fixes a crash when opening Markdown or code after the first render.

  • Keep the OpenTUI SyntaxStyle alive for the component lifetime; it is now destroyed only on cleanup. Previously renderer.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 bundle to avoid npm Git-dependency preparation on install.
  • dist/tui.js is prebuilt; nothing compiles on install.

Install:

git clone https://github.com/arthurrogado/opencode-file-browser ~/.config/opencode/plugins/file-browser

v0.2.0

Choose a tag to compare

@arthurrogado arthurrogado released this 07 Nov 23:39

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 (o in the browser, or Ctrl+X then O globally).
  • Toggle full screen with f to hide the chat.
  • TUI-only plugin for OpenCode V2.

Install:

git clone https://github.com/arthurrogado/opencode-file-browser ~/.config/opencode/plugins/file-browser