How to Check Which Branch You're On in Git

The fastest way to see your current branch

Run git branch in your terminal. Git will list all your local branches and put an asterisk (*) next to the one you're currently on. The branch name appears in a different color — usually green on most systems.

If you want only the branch name without the list, use git rev-parse --abbrev-ref HEAD. This prints just the name of your current branch, nothing else. It's useful when you're writing scripts or need clean output to pipe into another command.

A third option is git status, which shows your current branch at the top of the output along with information about uncommitted changes and unpushed commits. This is the command you'll run most often anyway, so you'll see your branch name every time you check your repository state.

Key Takeaways

git branch lists all local branches with an asterisk marking the one you're on.
git rev-parse --abbrev-ref HEAD prints only your current branch name, useful for scripts and automation.
git status shows your current branch at the top along with file changes and commit status.
The branch name also appears in your command prompt if you've configured Git prompt integration in your shell.
Visual Studio Code, JetBrains IDEs, and GitHub Desktop all display your current branch in their interface without needing terminal commands.

Understanding what git branch shows you

When you run git branch, you see only the branches that exist on your local machine. Remote branches — the ones stored on GitHub, GitLab, or another server — don't appear unless you ask for them. To see both local and remote branches, use git branch -a. Remote branches show with a remotes/origin/ prefix.

The asterisk next to your current branch is the key detail. If you're on main, you'll see * main. If you've just created a new branch called feature/login and switched to it, the asterisk moves to that line. The asterisk always marks where your HEAD pointer is — the commit you're currently working from.

If you have many branches, the output scrolls. You can search within it by piping to grep: git branch | grep feature will show only branches with "feature" in the name. This is faster than scrolling through a long list when you're working with dozens of branches.

Why your prompt might already show your branch

Many developers configure their shell prompt to display the current branch automatically. If you see the branch name in your command prompt — usually in parentheses or brackets after your directory path — you don't need to run a command at all. You're already looking at it.

This setup is common in Bash, Zsh, and Fish shells. If your prompt doesn't show it, you can add Git prompt integration by installing a tool like oh-my-zsh (for Zsh) or bash-git-prompt (for Bash). Many developers find this saves time because they see the branch name without typing anything, making it impossible to accidentally work on the wrong branch.

Checking your branch in a GUI or IDE

If you're using Visual Studio Code, the current branch name appears in the bottom left corner of the window, next to a branch icon. Clicking it opens a menu where you can switch branches without touching the terminal. Other editors like JetBrains IDEs (IntelliJ, PyCharm, WebStorm) show the branch name in the status bar at the bottom.

GitHub Desktop and other Git GUI clients display your current branch prominently at the top of the window. If you're not comfortable with the terminal yet, these tools make it obvious which branch you're on and make switching branches a single click. Some people prefer this approach even after learning terminal commands because it's faster than typing.

What to do if you're on the wrong branch

If you discover you're on the wrong branch, use git switch branch-name to move to the correct one. Replace branch-name with the actual name — for example, git switch main or git switch feature/login. The older command git checkout branch-name does the same thing, but git switch is clearer about what it does.

Before you switch, make sure you've committed or stashed any changes you've made. If you have uncommitted work, Git will warn you and refuse to switch. You can stash temporary work with git stash, switch branches, and then bring it back later with git stash pop. This prevents you from accidentally losing work when moving between branches.

Comparing the different methods

Each method for checking your branch has a different use case. git branch is best when you need to see all your local branches at once and decide which one to work on. git status is best when you're already checking your repository state and want branch information as part of that output. git rev-parse --abbrev-ref HEAD is best for scripts and automation where you need just the name with no extra formatting.

If you work in an IDE or GUI, checking the interface is often faster than opening a terminal at all. If you've set up shell prompt integration, you never need to run a command — the information is always visible. The method you choose depends on your workflow and what tools you already have open.

Frequently Asked Questions

What does the asterisk mean in git branch output?

The asterisk marks your current branch — the one your HEAD pointer is on. It's the branch where new commits will be recorded. Only one branch can have the asterisk at any time.

Why does git branch show branches I thought I deleted?

It doesn't. git branch shows only branches that still exist locally. If you see a branch you thought you deleted, it still exists. Use git branch -d branch-name to delete it, or git branch -D branch-name to force deletion if Git warns you about unmerged changes.

Can I see remote branches with git branch?

Not by default. git branch shows only local branches. Use git branch -a to see both local and remote branches, or git branch -r to see only remote branches. Remote branches appear with a remotes/origin/ prefix.

What if I'm in a detached HEAD state?

If you've checked out a specific commit instead of a branch, git branch shows * (HEAD detached at [commit-hash]). This means you're not on any branch. To get back to a branch, use git switch branch-name or git checkout branch-name.

How do I set up my shell prompt to show the branch name?

For Zsh, install oh-my-zsh and enable the git plugin in your .zshrc file. For Bash, install bash-git-prompt and follow its setup instructions. For Fish, the git branch is often shown by default. Each shell has different configuration steps, so check the tool's documentation for your specific shell.

This guide is for general information only and is not medical, financial, legal, or other professional advice. For decisions specific to your situation, consult a qualified professional. See our Editorial Policy.