Git Autopilot
Automatically trigger workflows based on git events like branches, commits, and tags
Git Autopilot monitors your repository activity and automatically suggests or starts workflows based on git events.
Overview#
When you create a feature branch, commit with a specific prefix, or tag a release, Bootspring can automatically:
- Suggest the appropriate workflow
- Start the workflow (if auto-start is enabled)
- Track the connection between git activity and workflows
How It Works#
Git Event Pattern Match Workflow Suggestion
─────────────────────────────────────────────────────────────
branch: feature/* ───▶ feature/* ───▶ Feature Development
commit: feat: ───▶ feat: ───▶ Feature Development
commit: security: ───▶ security: ───▶ Security Audit
files: prisma/* ───▶ prisma/ ───▶ Database Migration
tag: v1.0.0 ───▶ v* ───▶ Launch Preparation
Default Event Mappings#
Branch Patterns#
| Pattern | Workflow |
|---|---|
feature/* | feature-development |
fix/* | feature-development |
hotfix/* | security-audit |
release/* | launch-preparation |
perf/* | performance-optimization |
Commit Message Patterns#
| Prefix | Workflow |
|---|---|
feat: | feature-development |
fix: | feature-development |
security: | security-audit |
perf: | performance-optimization |
refactor: | performance-optimization |
File Change Patterns#
| Files | Workflow |
|---|---|
prisma/* | database-migration |
schema.prisma | database-migration |
src/api/* | api-development |
app/api/* | api-development |
Tag Patterns#
| Pattern | Workflow |
|---|---|
v* | launch-preparation |
release-* | launch-preparation |
Configuration#
Enable Autopilot#
Loading code block...
Configuration Options#
Loading code block...
Using Git Autopilot#
Viewing Suggestions#
When git events trigger suggestions:
Loading code block...
Accepting Suggestions#
Loading code block...
Dismissing Suggestions#
Loading code block...
Custom Event Mappings#
Adding Mappings#
Loading code block...
Removing Mappings#
Loading code block...
Best Practices#
- Start with suggestions - Use
requireConfirmation: trueuntil you trust the mappings - Ignore protected branches - Keep main/master/develop in
ignoreBranches - Use conventional commits - Autopilot works best with consistent commit prefixes
- Review mappings regularly - Adjust as your workflow evolves
Troubleshooting#
No suggestions appearing#
- Check if autopilot is enabled:
bootspring autopilot status - Verify branch isn't in
ignoreBranches - Check if event patterns match your naming conventions
Wrong workflow suggested#
- Review the event mappings:
bootspring autopilot mappings - Add more specific patterns to override defaults