English | 日本語
GitRight is a read-only Git history viewer for Codex. It opens the repository attached to the current task in a right-pane view with searchable graph and text history, commit details, changed files, and bounded file diffs.
GitRight is beta software. Interfaces and installation details may change between beta releases.
- macOS on Apple silicon (
arm64) - Codex with plugin and fullscreen MCP Apps support
- Git 2.30.0 or later
- A user-provided Bun runtime in the range
>=1.3.14 <2.0.0
GitRight does not bundle, download, install, or update Bun. Install a supported Bun 1.x release using the official Bun installation instructions before starting GitRight.
See Compatibility for the complete beta support boundary.
Add the GitRight beta marketplace and install the plugin:
codex plugin marketplace add hashi-yu/gitright --ref beta --json
codex plugin add gitright@gitright-beta --jsonOpen a Codex task that is attached to one Git repository, then ask Codex to open GitRight or select the GitRight plugin. GitRight requests the right pane and loads the available history for that task repository.
The marketplace operation and plugin installation may use the network. After the prerequisite and installation are complete, the GitRight runtime, including its first launch, makes no network requests.
If the gitright-beta marketplace is already registered, refresh its Git
snapshot first, then install the plugin again:
codex plugin marketplace upgrade gitright-beta --json
codex plugin add gitright@gitright-beta --jsonWithout the upgrade step, codex plugin add reinstalls the previously fetched
snapshot instead of the latest beta release. Like installation, the upgrade may
use the network.
Open a Codex task attached to one Git repository and start GitRight. The right pane loads the available history for that repository.
- Switch between the graph and text views with the toggle in the header.
- Search loaded commits by subject, SHA, or ref, and step through the matches.
- Select a commit to open the commit sheet: SHA, parents, author, dates, refs, commit message, and the changed files of the commit.
- Select a changed file to open its unified diff. Close the diff to return to the changed-file list.
- On a merge commit, choose which parent the changed files are compared with.
- Refresh reloads the history after the repository changes.
Selecting a commit or browsing its files sends nothing to the conversation. Only the explicit handoff, "Use commit SHA in conversation", adds anything, and it adds the full SHA of the selected commit alone.
This section is in preparation.
GitRight uses read-only Git operations. It does not modify the repository, working tree, Git configuration, hooks, or credentials. Repository content is kept inside the app surface. Selecting or browsing a commit does not send it to the conversation; an explicit handoff shares only the selected full commit SHA.
The Codex model transport is outside GitRight's runtime network boundary and may remain online.
Reproducible bug reports and feature proposals are welcome through GitHub Issues. Support is best effort: there is no response, resolution, merge, or roadmap deadline. GitHub Discussions, direct support, and email support are not offered for the beta.
Do not report security concerns or conduct incidents in a public Issue. Follow the Security Policy and Code of Conduct instead. Contributors should read Contributing.
Documentation is English-only. The English README is the canonical version, and the Japanese README is a translation of it. Where they differ, the English version prevails.
GitRight is available under the MIT License.
GitRight is not affiliated with or endorsed by the Git Project or Software Freedom Conservancy.