# stage-commit

The stage-commit command hands working-directory changes to a background commit subagent. Use it to create grouped commits and keep going until Git reports a clean tree.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 406 repo stars
- Author: syahiidkamil
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/commands/git/stage-commit.md
- Updated: 2026-06-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/stage-commit

## What it does

Run `/stage-commit` to start the `commit` subagent in the background. It stages eligible changes and makes separate commits for related work, repeating the process until `git status` shows a clean tree. The command does not wait for the agent to finish.

The agent keeps secrets, IDE files, logs, build outputs, and `.DS_Store` out of commits. When `.gitignore` does not exclude those files, it leaves them unstaged and reports that. Each commit message gets a trailer naming the current model, so that identity must be substituted before the task is handed off.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/stage-commit.md` — Call it with /stage-commit. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/stage-commit.md` — Call it with /prompts:stage-commit. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/stage-commit.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/stage-commit.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/tree/HEAD/.claude/commands/git/stage-commit.md

## When to use it
- Commit eligible changes across the working directory
- Split unrelated work into coherent commits
- Keep secrets and generated files out of the index
- Repeat commits until Git reports a clean tree

## Example prompts
- Run `/stage-commit` and commit the eligible changes in this working directory.
- Group related edits into separate commits and leave secrets unstaged.
- Keep going until `git status` shows a clean tree.

## Similar
- [ce-commit](https://affpapa.org/en/nevibecode/skills/ce-commit.md) — skill · 3600 installs
- [smart-commit](https://affpapa.org/en/nevibecode/hooks/smart-commit.md) — hook · 3745 installs
- [git-commit](https://affpapa.org/en/nevibecode/skills/thinkinaixyz-git-commit.md) — skill · 1 install
- [commit](https://affpapa.org/en/nevibecode/skills/getsentry-commit.md) — skill · 4900 installs
- [commit-all](https://affpapa.org/en/nevibecode/skills/sentimony-commit-all.md) — skill · 3800 installs
- [om-check-and-commit](https://affpapa.org/en/nevibecode/skills/om-check-and-commit.md) — skill · 3600 installs

From the same set: [syahiidkamil/software-engineer-ai-agent-atlas](https://affpapa.org/en/nevibecode/by/syahiidkamil/software-engineer-ai-agent-atlas.md) — 26 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
