@rizal72/oc-git

The repository's state, in the terminal and in the desktop app: the branch, then what has something to commit — added, modified, untracked — then ahead/behind, which appears only when an upstream exists.

Each count is grey at zero and warning-yellow when it is not, so a clean repository reads quietly. The branch being behind its upstream is the one other warning: it is never a resting state, so it turns the status yellow even with nothing to commit. The plugin draws nothing outside a repository or on a machine without git.

Install

opencode plugin add @rizal72/oc-git

Or by hand, one line in ~/.config/opencode/opencode.jsonc:

"plugins": ["@rizal72/oc-git"]

Update

V2 checks package plugins at startup and never applies the update, so a package only moves when you ask:

opencode plugin check     # which of the installed packages are behind
opencode plugin update    # apply them, and let the server reload

Or install @rizal72/oc-plugin-updates: the count appears in a pill above the composer, with the update one click away.

TUI

A block in the sidebar. While the repository is dirty the three counts also appear in the prompt footer, where a narrow window has no sidebar left.

GUI

A pill above the composer, with the whole state in its label: desktop +0 ±1 ?1, then ↑1 / ↓2 at the end only when there is something to push or pull — a zero there says nothing. Its rows spell out what the figures are — added, changed, untracked — plus the upstream when there is one.

How it works

One read of git status --porcelain=v2 --branch every three seconds, from the server half, shared by both surfaces; a tick is skipped while the previous read is still running. Read-only: no hook, no git server, nothing written.

Requires OpenCode v2. TypeScript, no build step, no runtime dependencies.