Let's F______| Go!

Local Workflow Automation

Streamlined Git workflow automation for local development with intelligent commit messages, safety checks, and GitHub integration.

One Command, Complete Workflow

Execute your entire Git workflow with a single command: stage changes, generate AI commit messages, commit with signatures, and push to remote.

  • ✓ Automatic staging with git add -A
  • ✓ AI-powered commit message generation
  • ✓ GPG signing and DCO support
  • ✓ Automatic push to origin
Complete workflow:
$ lfg
✓ Staging changes...
✓ Generating commit message...
✓ Committing with signature...
✓ Pushing to origin/feature-branch

Flexible Command Options

Workflow Control

--no-add Skip automatic staging
--no-push Commit only, don't push
--amend Amend the last commit
--offline Use template instead of AI

GitHub Integration

--pr Create pull request after push
--draft Create as draft PR
--review Specify reviewers
--labels Add labels to PR

Built-in Safety Checks

🛡️

Protected Branches

Double confirmation required for main/develop branches

📦

Large File Detection

Warns about large files and suggests Git LFS

🔐

Signature Verification

Ensures commits are properly signed when required

YAML Configuration

Repository Setup

Each repository gets its own .lfg/config.yml file with customizable settings for behavior, AI providers, and GitHub integration.

  • • Per-repository configuration
  • • Protected branch definitions
  • • AI provider and model settings
  • • GitHub integration options

Example Configuration

# .lfg/config.yml
base_branch: main
protected_branches: [main, develop]
ai:
provider: claude
method: cli
behavior:
require_signed_commits: true
require_dco: true

Pre & Post Hooks

⚡ Pre-run Hooks

Execute scripts before the commit process. Perfect for running tests, linting, or formatting.

# .lfg/pre-run.sh
pnpm format || exit 1
pnpm lint || exit 1
pnpm test || exit 1

🎯 Post-run Hooks

Execute scripts after successful completion. Great for notifications or opening PRs in browser.

# .lfg/post-run.sh
if [ -n "$PR_URL" ]; then
open "$PR_URL"
fi

Optimized for Speed

Designed for fast, efficient workflows with minimal overhead and intelligent caching.

Fast Execution

  • • Minimal dependencies
  • • Efficient diff processing
  • • Parallel operations where possible
  • • Smart caching of API calls

Resource Management

  • • Configurable timeouts
  • • Memory-efficient processing
  • • Automatic cleanup
  • • Graceful error handling

Developer Experience

  • • Clear progress indicators
  • • Helpful error messages
  • • Dry-run mode for testing
  • • Verbose logging option