# Codex Git Autopilot

> Use when committing or pushing completed work; automates gate-aware conventional commits with optional signing and CI/CD checks.

- Skill: `bang-isme/codex-git-autopilot` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bang-isme/codex-git-autopilot`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bang-isme/codex-git-autopilot/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: Bang-isme (https://skillmd.com/u/bang-isme)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/bang-isme/codex-git-autopilot

---


## 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

1. Activate when the user needs automated commit/push with safety gates.
2. Activate on explicit `$codex-git-autopilot` or `$auto-commit`.

Automates the commit-push cycle with production-grade safety.

## Pipeline

1. **Collect** - Only task-related files (explicit `--files` list)
2. **Stage** - `git add` specified files
3. **Gate** - Run `pre_commit_check.py` (lint, secret scan, debug check, tests)
4. **Message** - Auto-generate Conventional Commit (`feat(scope): description`)
5. **Sign** - GPG sign for GitHub Verified badge (auto-detect config)
6. **Push** - Auto-push to origin (never force push)

## Quick Commands

### Commit task-related files

```bash
python auto_commit.py --project-root ./ --files src/models/User.js src/routes/user.routes.js
```

### Commit with custom message

```bash
python auto_commit.py --project-root ./ --files src/models/User.js -m "feat(user): add email validation"
```

### Dry-run (preview)

```bash
python auto_commit.py --project-root ./ --files README.md --dry-run
```

### Setup GPG for Verified badge

```bash
python auto_commit.py --setup-gpg
```

## Safety Guarantees

- `NEVER` commits if pre-commit gate fails
- `NEVER` 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:

```bash
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)