unknown revision HEAD Git Origin: Build & delivery OSI layer 7 · Application Last updated 13 Oct 2026

fatal: ambiguous argument 'HEAD': unknown revision or path not in the working tree.

The repository has no commits yet (or the ref doesn’t exist), so HEAD can’t be resolved.

Exact message you may see ambiguous argument 'HEAD'unknown revision or path not in the working tree
Seen on: Git

Meaning

Fresh repositories, shallow CI clones, or typos in branch names. Tools that run git describe/rev-parse HEAD fail before the first commit.

Common causes

  • No commits yet
  • Typo in a revision name
  • Shallow clone missing the referenced commit

⚡ Quick fix

  1. Make an initial commit
  2. Fetch more history (fetch-depth: 0)
  3. Use -- to separate paths from revisions

Detailed fix by platform

Git

  1. git commit --allow-empty -m "Initial commit"

How to diagnose

  1. Commits — git log works?
  2. Recent change — Did it start after a deploy, upgrade, or configuration change? Compare with the last working version.

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Build & delivery. Errors that are often confused with or caused by this one (click to open):

Authentication failed — fatal: Authentication failed for 'https://github.com/x/y.git/' (Git)Authentication failedbranch exists — fatal: a branch named 'x' already exists (Git)branch existscannot lock ref — error: cannot lock ref 'refs/remotes/origin/x': is at … but expected … / unable to update local ref (Git)cannot lock refcannot rebase — error: cannot pull with rebase: You have unstaged changes. Please commit or stash them. (Git)cannot rebasedetached HEAD — You are in 'detached HEAD' state. (Git)detached HEADindex.lock exists — fatal: Unable to create '.git/index.lock': File exists. Another git process seems to be running in this repository (Git)index.lock existsLFS smudge error — Error downloading object: x: Smudge error / This repository is over its data quota (Git)LFS smudge errormerge commit revert — error: commit x is a merge but no -m option was given. (Git)merge commit revertunknown r…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.