Using Flo

Using Flo

Flo creates git worktrees from GitHub issues with automatic Claude context setup.

Commands

Starting Work

# From GitHub issue (fetches issue, creates branch, sets up Claude context)
flo 123

# From branch name (no GitHub integration)
flo feat/experiment

# Interactive picker (shows open issues)
flo

Issue mode auto:

• Assigns issue to you
• Creates branch: feat/123-title, fix/123-title, etc.
• Generates .claude/issue.md with issue context
• Copies Serena cache if present
• Runs pnpm install

Ending Work

# Merge PR, delete worktree/branch, sync main (default)
flo end

# Abandon work (close PR without merging)
flo end --resolve abort

# Skip validations (dirty worktree, failing checks)
flo end --force

# Clean up locally, don't touch PR
flo end --ignore pr

# Preview without executing
flo end --dry

Worktree Layout

~/projects/myproject/                    (main repo)
~/projects/myproject_feat-123-add-auth/  (worktree)
~/projects/myproject_fix-456-bug/        (worktree)

Notes

• Always use flo end (not rm -rf) to clean up worktrees
• If you did rm -rf, run flo prune to clean git metadata
• Run flo -h or flo <command> -h for detailed help