Workflows

This guide covers the main workflow in Autogit for creating and managing pull requests.

Smart PR State Machine

The PR command (8) is context-aware and performs different actions based on your current state:

Outcomes

Context	Action
On main + issue selected	Creates branch + worktree, switches to it, creates draft PR
On main + no issue	Opens popup to enter issue number
On feature branch + no PR	Creates standard PR (ready for review)
On feature branch + draft PR	Marks PR as ready for review
On feature branch + ready PR	Shows “PR is already published” message

Why Draft vs Standard?

Draft PR (when creating branch from issue on main):

• Signals to other agents that work has started on this issue
• Allows you to push early and get CI feedback
• Lets you iterate before marking ready for review

Standard PR (when submitting from existing feature branch):

• You’re explicitly ready to submit for review
• Created ready for review immediately

Typical Workflows

Starting Fresh (from issue)

1. On main branch, select an issue in the Issues panel
2. Press 8 (Smart PR)
3. Autogit creates a feature branch and a worktree for it
4. Autogit switches to the new worktree
5. Autogit creates a draft PR linking to the issue
6. Work on your changes, commit with 7 (Smart Commit)
7. When ready, press 8 again → PR marked ready for review

Why Worktrees?

The worktree-based workflow is optional but recommended—especially for multi-agent development. Each worktree is an isolated workspace, so you can run multiple AI agents in parallel without file conflicts. See the Worktrees guide for more.

Submitting Work (from existing branch)

1. On a feature branch with commits
2. Press 8 (Smart PR)
3. If no PR exists → creates standard PR (ready for review)
4. If draft exists → marks it ready for review

---

Keyboard Reference

Action	Key	Context
Smart Issue	6	Global
Smart Commit	7	Global
Smart PR	8	Global
Toggle auto-push	p	Commit popup

Next Steps

• Learn more about Smart Commit options
• See Worktrees for multi-agent development