Smart Issue

Smart Issue lets you describe a task in plain language and automatically generates a properly formatted GitHub issue, branch, and draft PR.

How It Works

1. Press 6 to open the Smart Issue popup
2. Type a description in natural language (e.g., “add dark mode to settings”)
3. AI generates:
   • A properly formatted issue title
   • A detailed issue body with context
   • A conventional branch name
4. Autogit creates the issue, branch, worktree, and draft PR—then switches you to the new worktree

Isolated Workspaces

The worktree-based workflow means each issue gets its own isolated directory. This is especially useful when running multiple AI coding agents in parallel—each agent works in its own worktree without file conflicts.

Why Use It?

Traditional workflow:

1. Go to GitHub
2. Create an issue with title and body
3. Copy the issue number
4. Create a branch locally
5. Create a worktree (optional)
6. Push the branch
7. Create a PR and link to the issue

With Smart Issue:

1. Press 6, type “add dark mode to settings”, press Enter
2. Done—you’re in a new worktree with a draft PR ready.

Example

You type:

fix the bug where users cant login after password reset

AI generates:

Title: Fix login failure after password reset

Body:

## Problem
Users are unable to login after completing a password reset flow.

## Expected Behavior
After resetting their password, users should be able to login with their new credentials.

## Acceptance Criteria
- [ ] Identify root cause of login failure after reset
- [ ] Implement fix
- [ ] Add test coverage for password reset flow

Branch: fix-login-failure-after-password-reset

Fits Into the Workflow

Smart Issue is the starting point of the development workflow:

1. Start — Press 6 to create issue, branch, worktree, and draft PR
2. Develop — Make changes in your isolated worktree, commit with 7
3. Ship — Press 8 to mark PR ready for review

The draft PR signals that work has started on this issue, preventing duplicate effort from other developers or AI agents. The worktree ensures your work is isolated from other in-progress features.

Keyboard Shortcuts

Key	Action
6	Open Smart Issue popup
Enter	Submit and create issue
Escape	Cancel

Tips

Write Like You’re Texting

Don’t worry about formatting. The AI handles capitalization, punctuation, and structure:

• add dark mode → “Add dark mode support”
• fix the login bug → “Fix login authentication failure”
• update readme with new api docs → “Update README with API documentation”

Be Specific When Needed

More context = better output:

• add button → Generic output
• add logout button to navbar that clears session → Detailed, specific output

One Issue at a Time

Keep each issue focused on a single task. This leads to:

• Smaller, reviewable PRs
• Clearer AI-generated content
• Faster iteration cycles