opencode-git-plugin 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 opencode-git-plugin contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,147 @@
+# Git Panel
+
+An OpenCode v2 TUI plugin that shows Git working-tree changes in the sidebar and opens file diffs in the native session panel.
+
+## Features
+
+- Sidebar list with `A`, `M`, and `D` badges plus per-file addition/deletion counts
+- Staged files marked as `[A]`, `[M]`, or `[D]`
+- Stage and unstage with the keyboard, command palette, or mouse
+- Commit staged files without leaving the TUI
+- Scrollable diff panel with line numbers and responsive controls
+- Search with highlighted matches and next/previous navigation
+- Optional persisted tree-sitter syntax highlighting
+- Automatic refresh from OpenCode events and a configurable polling interval
+- Safe handling of Git paths containing spaces, quotes, arrows, or newlines
+
+The plugin runs Git through OpenCode's local shell API. It does not contact an external service.
+
+## Screenshots
+
+| File list | List navigation | Diff panel |
+| --- | --- | --- |
+| ![Git Panel sidebar showing changed files with status badges](docs/panel.png) | ![Git Panel list navigation with stage and commit controls](docs/interactive.png) | ![Git Panel diff panel with syntax highlighting and search](docs/diff.png) |
+
+## Requirements
+
+- OpenCode `>=2.0.0 <3`
+- A Git repository as the active session directory
+
+## Install
+
+Install the published package with OpenCode:
+
+```sh
+opencode plugin add opencode-git-plugin
+```
+
+Git Panel is a TUI-only plugin, so `opencode plugin add` registers it in `~/.config/opencode/cli.json`. It stays active when the TUI connects to a remote server.
+
+Restart the OpenCode TUI after installation. Verify installation with:
+
+```sh
+opencode plugin list
+```
+
+### Update
+
+```sh
+opencode plugin check
+opencode plugin update
+```
+
+`check` reports whether a newer version is available; `update` installs it. Restart the TUI afterwards.
+
+### Uninstall
+
+```sh
+opencode plugin remove opencode-git-plugin
+```
+
+### Local development
+
+For local development, add the package directory to `~/.config/opencode/cli.json`:
+
+```jsonc
+{
+  "plugins": [
+    {
+      "package": "/absolute/path/to/git-changes",
+      "options": { "intervalMs": 4000 }
+    }
+  ]
+}
+```
+
+Fully quit and reopen the TUI after changing local plugin code.
+
+Do not add the plugin to `opencode.json(c)`; that file is for server plugins and Git Panel has no server entrypoint.
+
+## Options
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `intervalMs` | `number` | `4000` | Refresh interval in milliseconds; values below `1000` are clamped. |
+
+## Usage
+
+### File list
+
+- `<leader>G` (or palette: `Git Panel: Focus List`) enters list mode (yellow top/bottom border)
+- `↑` / `↓` move, `Enter` opens the diff, `→` stages, `←` unstages, `c` commits staged files, `ESC` exits
+- Click a row to open its diff; click the branch name to enter stage mode (every clicked file toggles staged/unstaged; branch click or `ESC` exits)
+- Clicking the prompt input exits list mode so typing is never hijacked
+- Staging also via palette (`Git Panel: Stage/Unstage File`)
+
+### Diff panel
+
+- `?` searches (yellow match highlight + match counter, `↑` / `↓` jump between matches), `ESC` clears the search, second `ESC` (or `Backspace`) closes the panel
+- `s`, the `[syntax:on/off]` header button, or palette (`Git Panel: Toggle Diff Syntax Highlighting`) toggles language syntax colors; default off, persisted across restarts
+- While searching, the view temporarily falls back to plain text so highlight + jump keep working
+- `j` / `k` scroll in syntax mode; mouse wheel works in both modes
+- Closing the panel returns to list mode
+- Plain diffs are truncated after 4,000 parsed lines to keep the TUI responsive
+
+### Commit
+
+- Green `[c : Commit]` button (or `c`, or palette: `Git Panel: Commit Staged`), visible only while files are staged and list mode is active; prompts for a message, then commits
+
+## States
+
+- `Loading…` while fetching
+- `Working tree clean` when there is nothing to show (header stats hidden)
+- `Empty repo — no commits yet` before the first commit
+- `Not a git repository` outside a repo, plus raw fetch errors
+
+## Development
+
+```sh
+bun install
+bun run check
+npm pack --dry-run
+```
+
+The package exposes only the `./tui` export (`tui.ts` at the package root, which re-exports `src/tui.tsx`). Local directory plugins are resolved as `<dir>/tui`, published packages through the `./tui` export.
+
+Any module that imports runtime values from `solid-js` (`createSignal`, `createMemo`, `onCleanup`, …) must be a `.tsx` file. OpenCode only redirects `solid-js` to its own runtime in `.jsx`/`.tsx` files; in a `.ts` file the import loads a second Solid instance and the UI stops updating. A test enforces this.
+
+Before publishing, test the packed tarball rather than the working directory:
+
+```sh
+bun pm pack
+mkdir -p /tmp/git-panel-smoke && cd /tmp/git-panel-smoke
+bun init -y && bun add /path/to/opencode-git-plugin-<version>.tgz
+```
+
+## Publish
+
+```sh
+npm login
+npm publish
+```
+
+The `prepublishOnly` script runs type checking and tests before npm publishes the package.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "opencode-git-plugin",
+  "version": "0.2.0",
+  "description": "OpenCode v2 TUI sidebar plugin listing git working-copy changes with diff preview",
+  "type": "module",
+  "exports": {
+    "./tui": "./tui.ts"
+  },
+  "files": [
+    "tui.ts",
+    "src",
+    "docs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "check": "bun run typecheck && bun test",
+    "prepublishOnly": "bun run check"
+  },
+  "dependencies": {
+    "@opencode/plugin": "^2.0.21",
+    "@opencode/theme": "^2.0.21"
+  },
+  "peerDependencies": {
+    "@opentui/core": ">=0.5.14",
+    "@opentui/solid": ">=0.5.14",
+    "solid-js": ">=1.9.0"
+  },
+  "devDependencies": {
+    "@opentui/core": "0.5.14",
+    "@opentui/solid": "0.5.14",
+    "solid-js": "1.9.12",
+    "typescript": "^5.6.0"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "tui",
+    "sidebar",
+    "git",
+    "vcs"
+  ],
+  "license": "MIT",
+  "author": "Aktug Urun",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aktug/opencode-git-plugin.git"
+  },
+  "homepage": "https://github.com/aktug/opencode-git-plugin#readme",
+  "bugs": {
+    "url": "https://github.com/aktug/opencode-git-plugin/issues"
+  },
+  "engines": {
+    "opencode": ">=2.0.0 <3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/config/constants.ts

@@ -0,0 +1,16 @@
+export const DEFAULT_INTERVAL_MS = 4000
+export const MIN_INTERVAL_MS = 1000
+export const MAX_DIFF_LINES = 4000
+export const GIT_TIMEOUT_MS = 120_000
+export const GIT_POLL_MS = 50
+
+export const DIFF_STORE_KEY = "git-panel.diff-view"
+export const DIFF_PANEL_NAME = "git-panel.diff"
+export const REFRESH_STORE_KEY = "git-panel.refresh"
+export const SETTINGS_STORE_KEY = "git-panel.settings"
+export const STAGED_STORE_KEY = "git-panel.staged"
+
+export const LIST_NAV_MODE = "git-panel-list"
+
+export const FILE_ROW_BADGE_WIDTH = 3
+export const EVENT_REFRESH_DEBOUNCE_MS = 2000

package/src/config/index.ts

@@ -0,0 +1,2 @@
+export * from "./constants"
+export * from "./options"

package/src/config/options.ts

@@ -0,0 +1,8 @@
+import type { Context } from "@opencode/plugin/tui/context"
+import { DEFAULT_INTERVAL_MS, MIN_INTERVAL_MS } from "./constants"
+
+export function intervalMs(ctx: Context): number {
+  const raw = ctx.options.intervalMs
+  if (typeof raw !== "number" || !Number.isFinite(raw)) return DEFAULT_INTERVAL_MS
+  return Math.max(MIN_INTERVAL_MS, Math.floor(raw))
+}

package/src/diff/body.tsx

@@ -0,0 +1,90 @@
+/** @jsxImportSource @opentui/solid */
+import { For, Show } from "solid-js"
+import type { generateSyntax } from "@opencode/theme/tui"
+import { diffLinePrefix, diffLineStyle, syntaxFiletype } from "../ui"
+import type { DiffRow, DiffViewState, ScrollHandle, Theme } from "../types"
+
+function DiffLineRow(props: { theme: Theme; row: DiffRow; index: number }) {
+  const theme = props.theme
+  const row = props.row
+  const style = diffLineStyle(theme, row.kind)
+  const isCurrent = row.state === "current"
+  const gutter = row.line !== undefined ? String(row.line).padStart(4, " ") : "    "
+  const fg = isCurrent
+    ? theme.diff.background.context
+    : row.state === "hit"
+      ? theme.text.feedback.warning.base
+      : style.fg
+  const bg = isCurrent ? theme.text.feedback.warning.base : style.bg
+  return (
+    <box flexDirection="row" width="100%" id={`git-panel-diff-line-${props.index}`}>
+      <text fg={isCurrent ? theme.text.feedback.warning.base : theme.text.muted} width={5}>
+        {isCurrent ? `❯${gutter.slice(1)}` : `${gutter} `}
+      </text>
+      <text fg={fg} bg={bg} wrapMode="word" flexGrow={1}>
+        {diffLinePrefix(row.kind)}
+        {row.text}
+      </text>
+    </box>
+  )
+}
+
+export function DiffBody(props: {
+  theme: Theme
+  state: DiffViewState
+  rows: DiffRow[]
+  focused: boolean
+  syntaxActive: boolean
+  syntaxStyle: ReturnType<typeof generateSyntax> | undefined
+  onScrollRef: (el: ScrollHandle) => void
+}) {
+  const theme = props.theme
+  return (
+    <>
+      <Show when={props.state.loading}>
+        <text fg={theme.text.muted}>Loading diff…</text>
+      </Show>
+      <Show when={!props.state.loading && props.state.message}>
+        <text fg={theme.text.muted}>{props.state.message}</text>
+      </Show>
+      <Show when={!props.state.loading && !props.state.message}>
+        <scrollbox
+          width="100%"
+          flexGrow={1}
+          flexShrink={1}
+          minHeight={0}
+          scrollY
+          scrollX={false}
+          focused={props.focused}
+          ref={(el) => props.onScrollRef(el)}
+          contentOptions={{ flexDirection: "column", gap: 0 }}
+          wrapperOptions={{ paddingRight: 1 }}
+        >
+          <Show when={props.syntaxActive}>
+            <diff
+              diff={props.state.patch}
+              view="unified"
+              filetype={syntaxFiletype(props.state.file)}
+              syntaxStyle={props.syntaxStyle}
+              showLineNumbers
+              wrapMode="word"
+              fg={theme.text.base}
+              addedBg={theme.diff.background.added}
+              removedBg={theme.diff.background.removed}
+              contextBg={theme.diff.background.context}
+              addedSignColor={theme.diff.text.added}
+              removedSignColor={theme.diff.text.removed}
+              lineNumberFg={theme.text.muted}
+            />
+          </Show>
+          <Show when={!props.syntaxActive}>
+            <For each={props.rows}>{(row, i) => <DiffLineRow theme={theme} row={row} index={i()} />}</For>
+          </Show>
+          <Show when={props.state.truncated}>
+            <text fg={theme.text.muted}>… truncated</text>
+          </Show>
+        </scrollbox>
+      </Show>
+    </>
+  )
+}

package/src/diff/header.tsx

@@ -0,0 +1,77 @@
+/** @jsxImportSource @opentui/solid */
+import { Show } from "solid-js"
+import { displayWidth, maxTextWidth, truncatePath } from "../ui"
+import type { Theme } from "../types"
+
+export function DiffHeader(props: {
+  theme: Theme
+  width: number
+  file: string
+  additions: number
+  deletions: number
+  query: string
+  matchCursor: number
+  matchCount: number
+  syntax: boolean
+  onSearch: () => void
+  onToggleSyntax: () => void
+  onClose: () => void
+}) {
+  const theme = props.theme
+  return (
+    <box flexDirection="column" gap={0} flexShrink={0}>
+      <box flexDirection="row" width={Math.max(1, props.width)} flexShrink={0}>
+        <text fg={theme.text.base} wrapMode="none" flexShrink={0}>
+          <b>
+            {truncatePath(
+              props.file,
+              maxTextWidth(
+                props.width,
+                displayWidth(`+${props.additions}`) + 1 + displayWidth(`-${props.deletions}`) + 1,
+              ),
+            )}
+          </b>
+        </text>
+        <box flexGrow={1} />
+        <box flexDirection="row" gap={1} flexShrink={0}>
+          <text fg={theme.diff.text.added} wrapMode="none" flexShrink={0}>
+            +{props.additions}
+          </text>
+          <text fg={theme.diff.text.removed} wrapMode="none" flexShrink={0}>
+            -{props.deletions}
+          </text>
+        </box>
+      </box>
+      <Show when={props.query}>
+        <text fg={theme.text.feedback.warning.base} wrapMode="none">
+          {props.matchCount > 0 ? `${props.matchCursor + 1}/${props.matchCount}` : "0/0"} · {props.query}
+        </text>
+      </Show>
+      <box height={1} flexShrink={0} />
+      <box flexDirection="row" flexWrap="wrap" width={Math.max(1, props.width)} gap={1} flexShrink={0}>
+        <text fg={theme.text.muted} wrapMode="none" flexShrink={0} onMouseUp={() => props.onSearch()}>
+          [? : Search]
+        </text>
+        <Show when={props.query}>
+          <text fg={theme.text.muted} wrapMode="none" flexShrink={0}>
+            [↑↓ : Jump]
+          </text>
+        </Show>
+        <text
+          fg={props.syntax ? theme.text.feedback.warning.base : theme.text.muted}
+          wrapMode="none"
+          flexShrink={0}
+          onMouseUp={() => props.onToggleSyntax()}
+        >
+          {props.syntax ? "[syntax:on]" : "[syntax:off]"}
+        </text>
+        <text fg={theme.text.base} wrapMode="none" flexShrink={0} onMouseUp={() => props.onClose()}>
+          [ Close · ESC/⌫ ]
+        </text>
+      </box>
+      <text fg={theme.text.muted} wrapMode="none">
+        {"─".repeat(Math.max(1, props.width))}
+      </text>
+    </box>
+  )
+}

package/src/diff/index.ts

@@ -0,0 +1,2 @@
+export { createDiffOpener } from "./open-diff"
+export { DiffPanel } from "./panel"

package/src/diff/keymap.ts

@@ -0,0 +1,113 @@
+import type { Context, PanelInput } from "@opencode/plugin/tui/context"
+import { DIFF_PANEL_NAME } from "../config"
+
+export function registerDiffKeymap(
+  ctx: Context,
+  deps: {
+    input: () => PanelInput
+    searching: () => boolean
+    hasMatches: () => boolean
+    syntaxActive: () => boolean
+    search(): void
+    stepMatch(dir: 1 | -1): void
+    clearSearch(): void
+    close(): void
+    toggleSyntax(): void
+    scrollBy(delta: number): void
+  },
+): void {
+  ctx.keymap.layer(() => {
+    const searching = deps.searching()
+    const hasMatches = deps.hasMatches()
+    const inSyntax = deps.syntaxActive()
+    return {
+      mode: "global",
+      priority: 20,
+      enabled: () => deps.input().name === DIFF_PANEL_NAME,
+      bindings: [
+        "git-panel.diff-search",
+        "git-panel.diff-next-match",
+        "git-panel.diff-prev-match",
+        "git-panel.diff-clear-search",
+        "git-panel.close-diff",
+        "git-panel.close-diff-backspace",
+        "git-panel.toggle-syntax",
+        "git-panel.syntax-down",
+        "git-panel.syntax-up",
+      ],
+      commands: [
+        {
+          id: "git-panel.diff-search",
+          title: "Git Panel: Search in Diff",
+          group: "Git Panel",
+          bind: "?",
+          run: () => deps.search(),
+        },
+        {
+          id: "git-panel.diff-next-match",
+          title: "Git Panel: Next Diff Match",
+          group: "Git Panel",
+          bind: "down",
+          enabled: searching && hasMatches,
+          run: () => deps.stepMatch(1),
+        },
+        {
+          id: "git-panel.diff-prev-match",
+          title: "Git Panel: Previous Diff Match",
+          group: "Git Panel",
+          bind: "up",
+          enabled: searching && hasMatches,
+          run: () => deps.stepMatch(-1),
+        },
+        {
+          id: "git-panel.diff-clear-search",
+          title: "Git Panel: Clear Diff Search",
+          group: "Git Panel",
+          bind: "escape",
+          enabled: searching,
+          run: () => deps.clearSearch(),
+        },
+        {
+          id: "git-panel.close-diff",
+          title: "Git Panel: Close Diff",
+          group: "Git Panel",
+          bind: "escape",
+          enabled: !searching,
+          run: () => deps.close(),
+        },
+        {
+          id: "git-panel.close-diff-backspace",
+          title: "Git Panel: Close Diff (Backspace)",
+          group: "Git Panel",
+          bind: "backspace",
+          enabled: !searching,
+          run: () => deps.close(),
+        },
+        {
+          id: "git-panel.toggle-syntax",
+          title: "Git Panel: Toggle Diff Syntax Highlighting",
+          group: "Git Panel",
+          bind: "s",
+          palette: true,
+          run: () => deps.toggleSyntax(),
+        },
+        {
+          id: "git-panel.syntax-down",
+          title: "Git Panel: Scroll Syntax Diff Down",
+          group: "Git Panel",
+          bind: "j",
+          enabled: inSyntax,
+          run: () => deps.scrollBy(3),
+        },
+        {
+          id: "git-panel.syntax-up",
+          title: "Git Panel: Scroll Syntax Diff Up",
+          group: "Git Panel",
+          bind: "k",
+          enabled: inSyntax,
+          run: () => deps.scrollBy(-3),
+        },
+      ],
+    }
+  })
+}

package/src/diff/open-diff.ts

@@ -0,0 +1,57 @@
+import type { Context } from "@opencode/plugin/tui/context"
+import { DIFF_PANEL_NAME, MAX_DIFF_LINES } from "../config"
+import { parseDiff } from "../git"
+import { useDiffStore } from "../state"
+import { friendlyError } from "../ui"
+import type { ChangeFile } from "../types"
+
+export function createDiffOpener(ctx: Context, location: () => { directory: string }) {
+  const [diffView, setDiffState] = useDiffStore(ctx)
+  let activeRequestId = 0
+
+  return async (f: ChangeFile) => {
+    const requestId = ++activeRequestId
+    const isStale = () => requestId !== activeRequestId || diffView.file !== f.file || !diffView.panelOpen
+
+    setDiffState((draft) => {
+      draft.file = f.file
+      draft.additions = f.additions
+      draft.deletions = f.deletions
+      draft.lines = []
+      draft.patch = ""
+      draft.message = ""
+      draft.truncated = false
+      draft.loading = true
+      draft.query = ""
+      draft.matchCursor = 0
+      draft.panelOpen = true
+    })
+    ctx.ui.panel.open(DIFF_PANEL_NAME, { presentation: "panel" })
+    try {
+      const res = await ctx.client.vcs.diff({ location: location(), mode: "working", context: 3 })
+      if (isStale()) return
+      const entry = res.data.find((d: { file: string }) => d.file === f.file)
+      const parsed = entry ? parseDiff(entry.patch) : []
+      setDiffState((draft) => {
+        draft.loading = false
+        draft.patch = entry?.patch ?? ""
+        if (!entry) {
+          draft.message = "No diff available"
+        } else if (parsed.length === 0) {
+          draft.message = "No visible changes (empty or binary file)"
+        } else if (parsed.length > MAX_DIFF_LINES) {
+          draft.lines = parsed.slice(0, MAX_DIFF_LINES)
+          draft.truncated = true
+        } else {
+          draft.lines = parsed
+        }
+      })
+    } catch (e) {
+      if (isStale()) return
+      setDiffState((draft) => {
+        draft.loading = false
+        draft.message = friendlyError(e)
+      })
+    }
+  }
+}