Oil Git CLI
Oil Git shows branches, changes and diffs in a separate window, and an agent opens a project with the oil-git command.
- 86 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill asks the agent to run local `oil-git` and system Git commands.
Install
- Works in
Manual install
Check `oil-git --version`. If the command is missing, tell the user and stop: a person confirms the app installation. Then run `oil-git inspect . --json` or `oil-git open . --view changes`.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill asks the agent to run local `oil-git` and system Git commands.
This is third-party code. Review the repository files before installing.
What it does
Oil Git is a desktop app for macOS and Windows that only reads a local Git repository. It shows the current branch, commit graph, tags, files with conflicts, staged and working changes, side-by-side or unified diffs and search inside a long diff. The package includes the `oil-git` command line and an Agent Skill. The `oil-git open . --view changes` command opens a project in the window, and `oil-git inspect . --json` prints a repository snapshot for an agent. The app makes no commits, switches no branches and changes no files, index or refs of the observed repository.
Who it is for. Developers who edit code with an agent and want to review repository changes without touching its state.
Good fit when
- The agent finished an edit and you need to review changes per file next to the original lines.
- You need to find one word in a long diff and step through all matches.
- A repository is in a merge or rebase state and conflicting files must be visible.
- An agent should open the project in the window with `oil-git open` with no manual folder search.
Not a fit when
- You need commits, branches, merges or resets from the interface: the app only reads.
- The repository is bare or a partial clone: such repositories are unsupported.
- You work on Linux: packages exist for macOS and Windows x64.
Example request
Open this project in Oil Git on the changes view and show which files the agent changed today.Limitations
Builds exist for macOS and Windows x64, and installers come from the releases page. Bare repositories and partial clones are unsupported, as are custom LFS commands and extensions. External filters and converters from repository configuration are not run, and if a safe read is impossible the app explains why. Upstream ahead and behind counts come from local records, and no `fetch` runs. The skill needs the installed app, system Git and permission to run local commands.
How to disable. Uninstall the Oil Git app and remove the skill from the agent skills directory. The app never changed repositories, so there is nothing to clean in them.
FAQ
How do I install Oil Git?
Download the macOS DMG or the Windows x64 installer from the GitHub releases page. The `oil-git` command and the Agent Skill ship in the package.
Can Oil Git damage my repository?
No. The app works in read mode, including configuration and LFS objects.
How do I show an agent where the skill is?
Run `oil-git skill --path`: the command prints the path to the Agent Skill from the package.
Which interface languages exist?
English and Simplified Chinese. For the command line choose the language with `--lang en` or `--lang zh-CN`.
What does inspect print?
A JSON snapshot of the local repository: `oil-git inspect . --json`. The command reads the repository and does not change it.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI that opens a local git diff in the browser like GitHub's Files changed tab; comments copy out as prompts for an agent
lazygit is a terminal Git interface for bisecting regressions: mark good and bad revisions while locating the faulty commit.
The gix and ein CLIs expose repository inspection and selected operations built on a Rust implementation of Git.
The CLI replays Git changes as typing animations to present commits and working-tree edits in the terminal.
A CLI that opens a git diff in the browser for keyboard review and hands comments to an agent as a prompt or to GitHub.
The CLI summarizes a local Git repository and its code statistics to give agents a concise starting point for project exploration.
README in short
The interface uses Tauri 2, React, TypeScript and Rust, and repositories are read through system Git. Dark, light and green themes are available.