ClaudeMods
☰
EN
● 0 online · Views 0 times
SponsorsSubmit a project
GitHub repositories · by choas

git-status

A Claude Code plugin that shows the current repo's branch, uncommitted files and unpushed commits in the footer.

Translated

About this mod

git-status is a small Claude Code plugin (part of the my-mods marketplace) that displays the git state of the session's working folder in the footer next to the mode labels. It shows the current branch (or short commit hash on a detached HEAD), the count of uncommitted entries (modified, staged, renamed, conflicted and untracked) as ●N, and the number of unpushed commits as ↑N. Indicators only appear when non-zero, and nothing is shown outside a git repository. The status refreshes on session start, on every prompt, after Bash/Edit/Write tool calls, and when the folder changes; it also follows cd inside Bash commands on its own. It runs git status --porcelain=v2 --branch with optional locks disabled and a 5 s timeout so it never blocks the repo, and requires git on PATH. Install via /plugin marketplace add choas/claude-mods followed by /plugin install git-status@my-mods, then /reload-plugins. Licensed MIT.

Installation

Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.

claude plugin marketplace add choas/claude-mods
claude plugin install git-status
Original text / README

my-mods

Small Claude Code mods that add live info to the footer, next to the mode labels.

| Mod | Shows | Example | | --- | --- | --- | | cwd-status | The folder Claude is working in, including where a Bash command cds to | 📁 ~/prj/app | | git-status | Branch, uncommitted files and unpushed commits of that folder's repo | ⎇ main ●3 ↑2 |

Together they read like 📁 ~/prj/app ⎇ main ●3 ↑2.

Install

In Claude Code, add this marketplace once:

/plugin marketplace add choas/claude-mods

Then install one or both mods:

/plugin install cwd-status@my-mods
/plugin install git-status@my-mods

Run /reload-plugins (or restart Claude Code) and the labels show up in the footer.

You can also browse and install them interactively with /plugin → Marketplaces → my-mods.

Update

/plugin marketplace update my-mods

Uninstall

/plugin uninstall cwd-status@my-mods
/plugin uninstall git-status@my-mods

cwd-status

Shows 📁 <folder> with your home folder shortened to ~.

  • Follows the session's working folder.
  • When a Bash command cds or pushdes somewhere (cd ../other && make), it shows that folder until the next tool runs.

git-status

Shows the git state of the current folder:

| Part | Meaning | | --- | --- | | ⎇ main | Current branch (short commit hash on a detached HEAD) | | ●3 | Uncommitted entries: modified, staged, renamed, conflicted and untracked | | ↑2 | Commits not pushed yet: ahead of the upstream, or, without an upstream, commits on no remote |

  • ● and ↑ only appear when non-zero; outside a git repo nothing is shown.
  • Refreshes when the session starts, on every prompt (so commits made in another terminal show up), after Bash/Edit/Write tool calls, and when the folder changes.
  • Follows cd inside Bash commands on its own, so it works without cwd-status.
  • Uses git status --porcelain=v2 --branch with optional locks off and a 5 s timeout, so it never blocks your repo.

Requires git on your PATH.

Development

Each mod is a plugin folder with a hooks module (hooks/register.ts), a state contract (types/index.d.ts) and tests:

claude plugin validate git-status
claude plugin test git-status

To try local changes, point Claude Code at the folder: claude --plugin-dir ./git-status.

License

MIT

Similar projects