CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

Format follows Keep a Changelog. Versioning follows SemVer.

Add your changes to [Unreleased]. They get moved into a version heading at release time.

Unreleased

0.19.2 — 2026-10-14

Added

• Added separate PR CI guards via just test-int for harness integration and just test-e2e for cache-installed OpenCode v1/v2 E2E editing, with exact prompt checks and no-plugin controls; local runs remain on demand and outside the unit suite.
• Added no-argument just test-e2e defaults for both pinned hosts, optional single-host selection, fresh temp receipts, private pinned bootstrap, and ignored path-only .env binary overrides; existing explicit CI paths remain supported.
• Added v1/v2 Terminal Control regressions for answer append followed by native paste in one PTY write, with synthetic question setup fixtures and exact visible-answer checks.

Fixed

• Custom question answers now support Vim editing on both OpenCode v1 and v2, starting in insert mode with isolated mode/undo state and preserving native answer submission, choice navigation and permissions (#78).
• Native paste in question answers now waits for queued Vim motions, preventing insertion at the previous cursor position.
• E2E startup failures retain the native exit status and current-scenario host error log instead of only reporting a closed readiness stream.

0.19.1 — 2026-10-04

Changed

• Added Vim-style subagent-navigation aliases to just dev and just dev2 alongside the arrow bindings for manual checks.

Fixed

• Remapped navigation keys now reach OpenCode in read-only child-session views without changing the Vim mode (#79).
• Corrected v2 root-session metadata so root prompts continue receiving Vim commands.
• Declared the OpenTUI keymap dev dependency so navigation regression tests run from clean installs.

0.19.0 — 2026-10-02

Added

• Experimental OpenCode v2 TUI support using a dual v1/v2 entrypoint and a renderer-key interception adapter, validated on OpenCode 2.0.15 on macOS.
• Optional installed-package compatibility harness with exact editor-state checks on pinned v1/v2 binaries; lightweight harness regressions run in CI without downloading hosts.
• just dev2 launches local source with a pinned OpenCode v2 release and separate .dev2/ settings/history.

Changed

• Started a gradual transition toward v2-only maintenance. v1 compatibility remains in v0.19.0; existing v1 users can stay pinned to the recommended v0.18.1 release.
• Document Git installation, options, and custom leader settings separately for OpenCode v1 and experimental v2.
• Corrected contributor paths for the split Vim engine and documented CI's compatibility-harness checks.

Fixed

• Visual h/l now selects through the cursor in both tested hosts, including backward motions, empty buffers and EOF/EOL boundaries, without resetting the native anchor for subsequent word or line motions. Visual mode re-anchors at the new prompt's cursor when the focused editor changes.
• The v2 form leader guard and Vim controller now share a per-activation disabled setting; external TUI toggles take effect on reload, local /vim toggles take effect immediately.
• Compatibility checks ignore user tmux configuration, reject JSONC project-config ancestors, and poll boundedly for asynchronous form/permission completion, retaining the last server response in receipts.
• Selection normalization no longer requires an installed @opentui/core type dependency; host-owned selection colors are forwarded unchanged.

0.18.1 — 2026-09-11

Changed

• Updated the documented cache-installed mode indicator limitation with the latest OpenCode and OpenTUI findings (#3).

Fixed

• Fixed Vim keys remaining unresponsive after dismissing or rejecting a question prompt (#72).

0.18.0 — 2026-09-02

Added

• Word text objects iw and aw, for use with the d, c, and y operators and in visual mode: diw, ciw, daw, viw, and so on (#57).
• Quote and bracket text objects i" i' i` i( i{ i[ i< (with a variants) for d/c/y and visual mode: di", ci(, vi[, and so on. iq/ib match the nearest quote/bracket of any type; ib means any bracket, not vim's parens-only ib.

Fixed

• After an operator, i/a now start a text object instead of switching to insert mode, so di and ci wait for the object key (#57).

0.17.1 — 2026-09-02

Fixed

• Arrow keys no longer get swallowed in normal and visual mode. They pass through to OpenCode, so you can exit the subagent view (and use other native navigation) without first switching to insert mode (#63).

0.17.0 — 2026-09-02

Changed

• Redesigned the vim engine into a modular architecture for easier maintenance and future keybindings. No change to existing keybindings or behavior.

Fixed

• dgg and drx no longer leave a stray operator that affected the next keypress.

0.16.0 — 2026-08-31

Added

• :w and :write now send the prompt instead of autocompleting to :wq and quitting OpenCode. Sessions auto-persist, so the natural mapping for vim users' reflexive "save" is to submit the current prompt. :wq still quits.

0.15.3 — 2026-07-01

Fixed

• Repeated e in visual mode now extends the selection progressively instead of getting stuck after the first press.

Fixed

• e in visual mode now moves to end of word instead of behaving like w (#52).

0.15.1 — 2026-06-23

Fixed

• Enter/Escape now work on subagent permission dialogs instead of being consumed by vim (#47).

0.15.0 — 2026-06-16

Fixed

• Non-printable leader keys (e.g. ctrl+x) now work in insert mode instead of being swallowed (#42).
• Escape from insert mode now moves cursor left, matching vim.
• Clipboard now uses wl-copy on Wayland instead of xclip, which doesn't work there.

0.14.0 — 2026-06-13

Added

• /vim toggle command to disable/enable vim mode. Persisted across restarts.
• Startup toast when vim is disabled so users know why keybindings aren't active.
• V selects the current line and enters visual mode.

Fixed

• Counted delete/change commands such as 3dw now undo in one u press instead of one undo per repeated host command.
• Leader key now works with modifier-based configurations like the default ctrl+x. Previously, parseLeaderKey expected vim-style C-x notation but OpenCode's keybinds API returns ctrl+x format, so the leader key was silently broken for any config with modifiers.
• Leader detection supports all OpenCode modifier aliases (control, alt, option, super) and multiple leader bindings.
• Optional chaining on api.kv.set to avoid crashes on older OpenCode versions.
• Escape/Enter no longer intercepted when vim is disabled.
• Toggling vim off resets mode and clears pending state.
• :vim palette title uses : prefix, consistent with :q/:quit/:wq.

0.13.0 — 2026-06-09

Changed

• Leader key is now auto-detected from OpenCode's keybinds.leader config. The leader plugin option has been removed.

Fixed

• Leader key (e.g. space) no longer enters pending-sequence state when typing in question or permission prompt overlays.

0.12.2 — 2026-06-08

Reverted

• Persistent mode indicator removed. The SolidJS slot approach doesn't work from git-installed plugins — the host's JSX runtime can't be resolved from the package cache. Back to toast-only for now (#3).

Changed

• modeIndicator option now accepts "toast" (default) or "none". The "status" value from v0.12.0 is gone until the host resolves JSX for external plugins.
• Ctrl+O one-shot normal now emits a proper mode action instead of a toast side-channel. The toast shows (insert) in lowercase, matching Vim convention.

0.12.0 — 2026-06-08

Added

• Persistent mode indicator next to the prompt (#3). Shows NORMAL, INSERT, VISUAL, or (insert) for one-shot normal. Replaces the old toast, which disappeared after a second.
• modeIndicator option: "status" (default, persistent label), "toast" (old behavior), or "none" (disabled). The old modeToast option still works as a fallback.

Changed

• Plugin entry point is now .tsx (was .ts) to support SolidJS slot rendering.

0.11.0 — 2026-06-08

Added

• :q, :quit, and :wq quit OpenCode from the command palette (#19). Since : already opens the palette, typing :q and pressing Enter exits the app.
• Ctrl+O in insert mode — run one normal-mode command, then return to insert. Motions, operators, counts, and r{char} all work.
• leader plugin option — lets you use space (or any key) as leader without breaking insert mode. Spaces type normally while editing, and leader sequences like space l still work in normal mode (#21).

0.10.0 — 2026-05-31

Added

• dG and cG — delete/change from cursor to end of buffer. yG already worked, now all three operators work with G.

Changed

• Cursor shape is set via the editor widget's cursorStyle property instead of writing DECSCUSR escape sequences to stdout. Fixes terminals that don't support DECSCUSR (e.g. macOS Terminal.app).

Fixed

• dG, cG, de, ce undo in a single u press. The host editor's undo system splits multi-line deletions into per-line entries, so these operations now go through editBuffer.deleteRange() with a pre-operation snapshot that u restores from directly.
• yy reads the cursor position from the editor widget instead of a line counter. The counter drifted on clicks, arrow keys, and word motions, causing yy to yank the wrong line.
• e moves to end of word instead of behaving like w. de, ce, and ye operate on the correct range too.
• g waits for a second keypress instead of jumping to buffer start on its own. gg now works as a proper two-key command.

0.9.0 — 2026-05-29

Added

• r{char} replaces the character under the cursor. Supports counts: 3ra replaces 3 characters with a.

0.8.0 — 2026-05-26

Added

• Yank with motions: yw, yb, ye, y$, y0, y^, yh, yl, yj, yk, yG. Previously only yy worked.
• Plugin init sanity test that catches crashes from hostile API shapes before release.
• Biome for linting and formatting, enforced in CI.
• just test, just lint, just lint-fix, just check recipes.

Fixed

• Plugin failed to load when api.kv didn't match the expected interface (e.g. object with no .get method). Broke installs on some OpenCode versions.

Changed

• README operators section rewritten to show d, c, and y side by side for each motion.
• Noted that e and w behave identically (the host has no separate end-of-word command).

0.7.0 — 2026-05-26

Added

• Cross-platform clipboard. Yank/paste now works on macOS (pbcopy), Windows (clip.exe), and Linux (xclip). Previously macOS-only.
• Plugin configuration via tui.json tuple syntax. Three options available:
  • updateCheck — disable the daily GitHub version check.
  • modeToast — disable the mode-switch toast, relying on cursor shape alone.
  • startMode — start in normal mode instead of insert.
• Daily caching for the update checker via api.kv. Previously checked GitHub on every launch.
• GitHub Actions CI — runs bun test on push and PR to main.
• Issue templates for bug reports and missing keybinding requests.
• Version sync test — catches drift between VERSION and package.json at test time.
• typecheck script (tsc --noEmit) in package.json.
• MIT LICENSE file.

Changed

• Removed unused devDependencies (@opentui/core, @opentui/keymap, @opentui/solid, solid-js). Pinned @opencode-ai/plugin to ^1.15.4.
• Removed private: true from package.json.
• Dropped lockfiles from git. Plugin consumers resolve their own deps.
• Replaced local paths in AGENTS.md with public GitHub URLs.
• Fixed g/gg contradiction in README — g removed from keybinding tables.
• Added platform notes and configuration sections to README.

0.6.1 — 2026-05-25

Changed

• Updated AGENTS.md with current line counts and visual mode status in known limitations.

Removed

• Dead readClipboard() export from clipboard module.
• Stale implementation plan (docs/plan.md) from initial prototype.

0.6.0 — 2026-05-24

Added

• Character-wise visual mode (v). Select text with motions, then d/x to delete, c to change, y to yank. All normal-mode motions work for extending the selection, with counts.
• Tab inserts a tab character in insert mode. Previously fell through to OpenCode's default handler because the plugin had no way to insert text at the cursor. Now uses insertText on the focused editor directly.

Fixed

• j/k now move the cursor up/down in multi-line text. Previously they always dispatched prompt history commands because the plugin read prompt text from api.prompt which doesn't exist. Now reads from api.renderer.currentFocusedEditor.plainText.
• d in visual mode deletes the full selection instead of just the last character. The clearSelection action was racing the deferred input.backspace command.
• Block cursor now shows in visual mode (not just normal mode).

0.5.0 — 2026-05-24

Removed

• Tab insertion in insert mode. The clipboard-based workaround (write tab to clipboard, paste, restore) clobbered the user's clipboard and raced with async I/O. Tab now falls through to OpenCode's default handler.

0.4.0 — 2026-05-24

Added

• / in normal mode opens the session timeline (jump-to-message picker).
• [/] scroll the conversation view half a page up/down.
• {/} jump to the previous/next message in the conversation.
• translateKey now maps shift+[ → { and shift+] → }.

0.3.3 — 2026-05-21

Fixed

• Update check now uses GitHub API instead of raw.githubusercontent.com, which caches content for up to 5 minutes.

0.3.2 — 2026-05-21

No user-facing changes. Version bump to test the update notification.

0.3.1 — 2026-05-21

Added

• Update check on launch. Shows a toast when a newer version is available on GitHub.

Changed

• Install instructions now pin a version tag (#v0.3.1). Changing the tag in tui.json invalidates the cache and pulls the new version on next launch.

Fixed

• Cursor shape now works for git-installed plugins, not just just dev. Switched from addPostProcessFn (unavailable in the cache context) to a direct DECSCUSR interval.

0.3.0 — 2026-05-20

Added

• Cursor shape changes with mode: block in normal mode, bar in insert mode. Uses DECSCUSR escape sequences via a post-render hook, bypassing the Textarea's hardcoded block cursor.

0.2.2 — 2026-05-20

Fixed

• Vimcode now passes through all keys when any overlay is active (command palette, session list, question prompts, permission prompts). Previously vim consumed j/k/Enter/Escape before these UIs could handle them.

0.2.1 — 2026-05-20

Fixed

• Vim keybindings no longer interfere with the question tool. When the AI asks a question with selectable options, vimcode passes through all keys.

0.2.0 — 2026-05-20

Added

• Ctrl+Enter submits the prompt from insert mode. Previously there was no way to submit without switching to normal first.
• j/k in normal mode cycle through prompt history when the input is empty, matching up/down arrow behavior.

Fixed

• File picker and autocomplete work in insert mode. Enter picks the selected item and Escape closes the picker without leaving insert. Previously the vim intercept consumed both keys before the autocomplete layer saw them.

0.1.4 — 2026-05-20

Added

• Colored mode indicator in the prompt bar when running from source (just dev). Falls back to toast for git/npm installs where the host runtime modules can't be imported.

0.1.3 — 2026-05-20

Fixed

• Git URL installation works. Removed all external runtime imports (solid-js, @opentui/solid) since OpenCode's runtime module plugin doesn't resolve host packages for cache-installed plugins.

Changed

• Mode indicator replaced with toast notifications. Toast shows "NORMAL" or "INSERT" briefly on each switch.

Removed

• indicator.ts (no longer needed without the slot-based indicator).

0.1.2 — 2026-05-19

Fixed

• Git URL installation works. Replaced JSX with programmatic rendering to avoid jsx-dev-runtime resolution failure from the package cache path.

0.1.1 — 2026-05-19

Fixed

• Git URL installation (vimcode@git+https://... in tui.json) no longer fails with jsxDEV not found. Peer deps moved to devDependencies so type stubs don't shadow the host runtime.

Changed

• Removed unnecessary "." export from package.json. Only "./tui" is needed by the plugin loader.

0.1.0 — 2026-05-18

First release. Modal editing for the OpenCode prompt.

Added

• Normal and insert modes, toggled by Escape and insert-entry keys.
• Mode indicator in the prompt bar (NORMAL/INSERT).
• Normal mode motions: h, j, k, l, w, b, e, 0, ^, $, g, G.
• Numeric counts for all motions (3j, 5w, etc.).
• Operators d (delete), c (change), y (yank) with motion combinations (dw, c$, yb).
• Doubled operators for line-wise action: dd, cc, yy.
• Counts on both operator and motion (2d3w).
• D and C shortcuts for delete/change to end of line.
• Insert entries: i, a, A, o, O.
• x, X, u, Ctrl+r, p, J, :, Enter.
• Insert mode Enter inserts a newline.
• Yank copies to system clipboard via pbcopy.

g fires immediately as buffer-home instead of waiting for gg. The yy line tracker drifts on clicks and arrow keys. Visual mode and text objects aren't feasible without cursor position access.