Skip to content
Development
Command

/flow-status

Display comprehensive Git Flow status including branch type, sync status, changes, and merge targets

From plugin
claude-code-templates
30k200 skills200 agents200 commands2 MCP
Install
$ npx -y skills add davila7/claude-code-templates --agent claude-code

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/flow-status

Context preview

What this command does when you run it.

Display comprehensive Git Flow status including branch type, sync status, changes, and merge targets

Command definition

flow-status.md
allowed-tools: Bash(git:*), Read
description: Display comprehensive Git Flow status including branch type, sync status, changes, and merge targets

Git Flow Status

Display comprehensive Git Flow repository status

Current Repository State

  • Current branch: !`git branch --show-current`
  • Git status: !`git status --porcelain`
  • Branch list: !`git branch -a | grep -E '(feature|release|hotfix|develop|main)' | head -20`
  • Latest tags: !`git tag --sort=-version:refname | head -5`
  • Recent commits: !`git log --oneline --graph --all -10`
  • Remote status: !`git remote -v`

Task

Provide a comprehensive Git Flow status report:

1. Branch Analysis

Determine current branch type and state:

CURRENT_BRANCH=$(git branch --show-current)

# Detect branch type
if [[ $CURRENT_BRANCH == "main" ]]; then
  BRANCH_TYPE="๐Ÿ  Production"
  ICON="๐Ÿ "
  STATUS_COLOR="red"
elif [[ $CURRENT_BRANCH == "develop" ]]; then
  BRANCH_TYPE="๐Ÿ”€ Integration"
  ICON="๐Ÿ”€"
  STATUS_COLOR="blue"
elif [[ $CURRENT_BRANCH == feature/* ]]; then
  BRANCH_TYPE="๐ŸŒฟ Feature"
  ICON="๐ŸŒฟ"
  STATUS_COLOR="green"
elif [[ $CURRENT_BRANCH == release/* ]]; then
  BRANCH_TYPE="๐Ÿš€ Release"
  ICON="๐Ÿš€"
  STATUS_COLOR="yellow"
elif [[ $CURRENT_BRANCH == hotfix/* ]]; then
  BRANCH_TYPE="๐Ÿ”ฅ Hotfix"
  ICON="๐Ÿ”ฅ"
  STATUS_COLOR="red"
else
  BRANCH_TYPE="๐Ÿ“ Other"
  ICON="๐Ÿ“"
  STATUS_COLOR="gray"
fi

2. Comprehensive Status Display

โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”
๐ŸŒฟ GIT FLOW STATUS
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”

๐Ÿ“ CURRENT BRANCH
   $ICON $CURRENT_BRANCH
   Type: $BRANCH_TYPE
   Base: [origin branch]
   Target: [merge destination]

๐Ÿ“Š REPOSITORY INFO
   Remote: origin ($REMOTE_URL)
   Latest tag: v1.2.0
   Total branches: 12
   Active features: 3
   Active releases: 0
   Active hotfixes: 0

๐Ÿ”„ SYNC STATUS
   Commits ahead: โ†‘ 2
   Commits behind: โ†“ 1
   Status: โš ๏ธ  Branch diverged from remote

   Recommendations:
   - Pull latest changes: git pull
   - Push your commits: git push

๐Ÿ“ WORKING DIRECTORY
   Modified: โ— 3 files
   Added: โœš 5 files
   Deleted: โœ– 1 file
   Untracked: ? 2 files
   Total changes: 11 files

   Status: โš ๏ธ  Uncommitted changes

๐Ÿ“ˆ COMMIT HISTORY
   Commits on branch: 5
   Commits since base: 7
   Last commit: 2 hours ago
   Author: John Doe <john@example.com>

๐ŸŽฏ MERGE TARGET
   Will merge to: develop
   Merge status: โœ“ Ready (no conflicts)

   Estimated files affected: 12
   Estimated lines changed: +245 -87

๐Ÿท๏ธ  VERSION INFO
   Current production: v1.2.0 (on main)
   Last release: 3 days ago
   Next suggested: v1.3.0 (based on commits)

โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”

3. Branch-Specific Information

**For Feature Branches:**

๐ŸŒฟ FEATURE BRANCH: feature/user-authentication

Branch info:
  Created: 2 days ago
  Base branch: develop
  Merge target: develop

Progress:
  Commits: 5
  Files changed: 12
  Lines added: 245
  Lines removed: 87

Status:
  โœ“ No merge conflicts with develop
  โœ“ Branch is up to date with remote
  โš ๏ธ  3 uncommitted changes
  โš ๏ธ  Tests not run recently

Next steps:
  1. Commit your changes
  2. Run tests: npm test
  3. Push to remote: git push
  4. When ready: /finish

**For Release Branches:**

๐Ÿš€ RELEASE BRANCH: release/v1.3.0

Release info:
  Version: v1.3.0
  Created: 1 day ago
  Base branch: develop
  Merge targets: main, develop

Release contents:
  Features: 5
  Bug fixes: 3
  Performance: 1
  Total commits: 15

Version analysis:
  Current: v1.2.0
  Proposed: v1.3.0
  Increment: MINOR (new features)

Checklist:
  โœ“ CHANGELOG.md updated
  โœ“ Version in package.json
  โš ๏ธ  Tests not run
  โœ— No tag created yet

Next steps:
  1. Run final tests: npm test
  2. Review CHANGELOG.md
  3. Create PR: gh pr create
  4. Get approvals
  5. Finish release: /finish

**For Hotfix Branches:**

๐Ÿ”ฅ HOTFIX BRANCH: hotfix/critical-security-patch

Hotfix info:
  Issue: critical-security-patch
  Created: 2 hours ago
  Base branch: main
  Merge targets: main, develop
  Severity: CRITICAL

Version info:
  Current production: v1.2.0
  Hotfix version: v1.2.1
  Increment: PATCH

Status:
  โœ“ Fix implemented
  โœ“ Tests passing
  โš ๏ธ  Not yet deployed
  โš ๏ธ  2 uncommitted changes

โš ๏ธ  URGENT: This is a critical production hotfix!

Next steps:
  1. Commit remaining changes
  2. Final testing
  3. Create emergency PR
  4. Get fast-track approval
  5. Finish and deploy: /finish
  6. Monitor production

**For Main Branch:**

๐Ÿ  MAIN BRANCH (Production)

Production info:
  Latest tag: v1.2.0
  Released: 3 days ago
  Last commit: 3 days ago
  Status: โœ“ Clean and stable

Active work:
  Feature branches: 3
  Release branches: 0
  Hotfix branches: 0

Recent releases:
  v1.2.0 - 3 days ago
  v1.1.5 - 1 week ago
  v1.1.4 - 2 weeks ago

โš ๏ธ  WARNING: You are on the production branch!

Avoid committing directly to main.
Use feature/release/hotfix branches instead.

To start new work:
  /feature <name>    - New feature
  /release <version> - New release
  /hotfix <name>     - Emergency fix

**For Develop Branch:**

๐Ÿ”€ DEVELOP BRANCH (Integration)

Integration info:
  Ahead of main: 12 commits
  Last merge: 1 day ago
  Status: โœ“ Stable

Merged features:
  feature/user-authentication (2 days ago)
  feature/payment-gateway (1 week ago)
  feature/dashboard-redesign (2 weeks ago)

Active features:
  feature/notifications (in progress)
  feature/api-v2 (in progress)
  feature/mobile-app (in progress)

Next release:
  Suggested version: v1.3.0
  Estimated features: 5
  Estimated timeline: 1 week

To start new work:
  /feature <name> - Create new feature

4. All Git Flow Branches

List all active Git Flow branches:

๐Ÿ“‹ ACTIVE BRANCHES

๐ŸŒฟ Features (3):
  feature/notifications        (2 commits, 1 day old)
  feature/api-v2              (8 commits, 1 week old)
  feature/mobile-app          (15 commits, 2 weeks old)

๐Ÿš€ Releases (0):
  No active releases

๐Ÿ”ฅ Hotfixes (0):
  No active hotfixes

๐Ÿ  Mai
Read more
Ships withclaude-code-templates

Ready-to-use configurations for Anthropic's Claude Code. A comprehensive collection of AI agents, custom commands, settings, hooks, external integrations (MCPs), and project templates to enhance your development workflow.

Get the whole plugin, auto-invoked
Stats
30,155
Stars
18
Views
3,377
Forks
Active
Maintenance
Python
Language
MIT
License
28m ago
Last commit
1y ago
Created

Repo: davila7/claude-code-templates