Skip to content

Screenshots for git-stats, and cross-links between the two plugins - #27

Merged
navbytes merged 1 commit into
mainfrom
docs-screenshots
Sep 10, 2026
Merged

navbytes merged 1 commit into
mainfrom
docs-screenshots

Conversation

@navbytes

Copy link
Copy Markdown
Owner

git-stats had no picture, which for a plugin whose whole point is a colour-coded
chip is the wrong thing to leave to the imagination.

Two shots, both captured by driving a real OpenCode TUI through the pty harness and
rendering the composed screen — the same rig that produced context-tree's existing
screenshots:

  • sidebar-card.png — the card in the sidebar beside the host's own Context and
    LSP sections, showing the working-tree figures and all four chip colours.
  • prs-dialog.png — the /prs picker, each row carrying the pull request's title.

The chips are real

Read live from gh, in real states. cli/cli happens to have draft, open, closed and
merged pull requests open at once; this repo's own 26 PRs are all merged, so a capture
here could only ever have shown one colour. Staging fake states would have produced a
prettier picture of something the plugin does not do.

The figures are real as well — the fixture repo has README.md +2, parser.ts +4/-2,
and an untracked 2-line version.ts, which is exactly the +8 -2 · 3 files on screen.

Cross-links

Both READMEs now point at each other. The repo holds two plugins, and someone landing
on one should learn the other exists.

Screenshots are not added to either package's files array, matching context-tree:
npm resolves relative README image paths against repository.directory, so they render
on the npm page without shipping in the tarball.

git-stats had no picture, which for a plugin whose whole point is a colour-coded
chip is the wrong thing to leave to the imagination. Two shots, both captured by
driving a real OpenCode TUI through the pty harness and rendering the composed
screen (the same rig that produced context-tree's screenshots):

- sidebar-card.png — the card in the sidebar, next to the host's own Context and
  LSP sections, showing the working-tree figures and all four chip colours.
- prs-dialog.png — the /prs picker, each row carrying the pull request's title.

The chips are real pull requests in real states, read live from `gh`: cli/cli has
draft, open, closed and merged open at once, and this repo's own PRs are all
merged, so a capture here could only ever show one colour. Staging fake states
would have made a prettier picture of something the plugin does not do.

The figures in the shot are real too: the fixture repo has README +2, parser.ts
+4/-2 and an untracked 2-line version.ts, which is exactly the `+8 -2 · 3 files`
on screen.

Both READMEs now point at each other, since the repo holds two plugins and
someone landing on one should learn the other exists.
@navbytes
navbytes merged commit 93e436e into main Sep 10, 2026
1 check passed
@navbytes
navbytes deleted the docs-screenshots branch September 10, 2026 13:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant