| name | codex-git-autopilot |
| description | Use when committing or pushing completed work; automates gate-aware conventional commits with optional signing and CI/CD checks. |
| load_priority | on-demand |
TL;DR
Collect files → stage → run pre-commit gate → generate conventional commit → GPG sign → push. Never commits on gate failure, never force pushes.
Git Autopilot
Activation
- Activate when the user needs automated commit/push with safety gates.
- Activate on explicit
$codex-git-autopilot or $auto-commit.
Automates the commit-push cycle with production-grade safety.
Pipeline
- Collect - Only task-related files (explicit
--files list)
- Stage -
git add specified files
- Gate - Run
pre_commit_check.py (lint, secret scan, debug check, tests)
- Message - Auto-generate Conventional Commit (
feat(scope): description)
- Sign - GPG sign for GitHub Verified badge (auto-detect config)
- Push - Auto-push to origin (never force push)
Quick Commands
Commit task-related files
python auto_commit.py --project-root ./ --files src/models/User.js src/routes/user.routes.js
Commit with custom message
python auto_commit.py --project-root ./ --files src/models/User.js -m "feat(user): add email validation"
Dry-run (preview)
python auto_commit.py --project-root ./ --files README.md --dry-run
Setup GPG for Verified badge
python auto_commit.py --setup-gpg
Safety Guarantees
NEVER commits if pre-commit gate failsNEVER force pushes- Unstages files on gate failure (clean state)
- Falls back to unsigned commit if GPG fails
- Timeout on all git operations (60s)
- Conventional Commits format (CI/CD compatible)
GPG Setup (One-Time)
Run python auto_commit.py --setup-gpg for interactive guide, or:
winget install GnuPG.GnuPG
gpg --quick-generate-key "your@email.com" rsa4096 sign never
gpg --list-secret-keys --keyid-format=long
git config --global user.signingkey YOUR_KEY_ID
git config --global commit.gpgsign true
gpg --armor --export YOUR_KEY_ID
Paste the exported key in GitHub Settings > SSH and GPG Keys > New GPG Key.
Integration
This skill integrates with:
codex-execution-quality-gate/scripts/pre_commit_check.py (CI gate)codex-project-memory/scripts/generate_changelog.py (reads commit history)
