auto-stage — плагин для Claude Code: что делает и как установить
Плагин auto-stage для Claude Code автоматически добавляет изменённые ассистентом файлы в индекс Git, устраняя ручной вызов git add перед коммитом.
MIT ★ 586 обновлён 2026-10-26
/plugin marketplace add karanb192/claude-code-hooks
/plugin install auto-stage@claude-code-hooksЧто делает auto-stage
Плагин подключает синхронный хук PostToolUse на события Edit и Write. Как только Claude Code правит или создаёт файл, хук определяет путь и выполняет команду git add -- <file> прямо в каталоге файла. В итоге рабочий индекс совпадает со списком правок ассистента. Статус репозитория остаётся наглядным.
Вызов утилиты Git происходит без запуска шелла через execFileSync, поэтому спецсимволы в именах файлов защищены от инъекций команд. Плагин уважает .gitignore и не использует принудительное добавление: игнорируемые файлы не попадут в индекс, а ошибка запишется в журнал ~/.claude/hooks-logs/<date>.jsonl. Хук всегда завершается с кодом 0 и никогда не блокирует инструмент.
Настроек у плагина нет, поэтому отключить автоиндексацию для отдельных каталогов внутри репозитория без правки .gitignore не получится.
Какие задачи решает
- автоматически добавлять изменённые ассистентом файлы в индекс Git
- просматривать точный список правок Claude Code через команду
git status - исключать случайный пропуск модифицированных файлов перед созданием коммита
Примеры запросов агенту
- Поправь валидацию в
src/auth.tsи проверь статус репозитория - Перепиши компонент
Button.tsxи создай для него модульный тест
Как установить auto-stage
Через маркетплейс плагинов
/plugin marketplace add karanb192/claude-code-hooks/plugin install auto-stage@claude-code-hooksПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы об auto-stage
Как установить auto-stage в Claude Code?
Выполните в Claude Code команду /plugin marketplace add karanb192/claude-code-hooks, затем /plugin install auto-stage@claude-code-hooks и перезапустите сессию.
Что делает плагин auto-stage?
Он перехватывает операции Edit и Write и сразу вызывает git add для каждого затронутого файла, удерживая индекс синхронизированным.
Добавит ли хук файлы из .gitignore?
Нет, хук не использует флаги принудительного добавления, поэтому игнорируемые файлы не попадают в коммит, а событие фиксируется в журнале.
Исходный текст
auto-stage · MIT
# auto-stage
> Automatically git stages files after Claude modifies them, so `git status` always shows exactly what Claude touched.
A `PostToolUse` hook fires after every `Edit` and `Write` call, resolves the modified file's path (relative paths are resolved against the session's cwd), checks that it lives inside a git repo, and runs `git add` on it. Review becomes trivial: the staged set IS Claude's change set, and nothing needs manual staging before you commit. The hook stays synchronous on purpose: staging must complete before any later `git commit` in the same turn sees the index.
## Install
```
/plugin marketplace add karanb192/claude-code-hooks # once per machine
/plugin install auto-stage@claude-code-hooks
```
Restart Claude Code, done. (Or from a shell: `claude plugin install auto-stage@claude-code-hooks`.)
## What it does
| Event | Runs | What happens |
|-------|------|--------------|
| PostToolUse (`Edit\|Write`) | sync | Resolves the file path, skips files outside a git repo, runs `git add -- <file>` in the file's directory, logs the outcome. |
Every outcome (`STAGED`, `SKIP`, `ERROR`) is appended to `~/.claude/hooks-logs/<date>.jsonl`. The hook always exits 0 and prints `{}`; it never blocks the tool call, even on malformed input.
## Configuration
None. The hook has no tunables, no safety levels, and no ask mode. The only environment variable it reads is `HOME`, to place its log under `~/.claude/hooks-logs/`.
## Safety notes
- **.gitignore is your guard.** Ignored files (`.env`, keys, etc.) fail `git add` and the failure is logged; nothing is ever force-added.
- **Shell-free staging.** The path is passed as an argv element via `execFileSync`, so quotes, `$()`, and backticks in a filename cannot break out, and `--` stops a leading dash from being read as a git option.
- **No network calls.** The script only uses `fs`, `path`, and `child_process` (for git), so everything stays on your local machine.
## Uninstall
```
/plugin uninstall auto-stage@claude-code-hooks
```
---
Part of [claude-code-hooks](https://github.com/karanb192/claude-code-hooks).
© Karan Bansal · MIT · karanb192/claude-code-hooks