Git "fatal: could not read Username" - No Credential in CI

By Kaveh Alemi·Latchkey

Git needed a username for an HTTPS operation, had no credential helper or token to provide one, and could not prompt because CI has no terminal. With prompts disabled it fails immediately rather than hanging.

What this error means

An HTTPS clone/fetch/push fails with fatal: could not read Username for 'https://github.com': terminal prompts disabled. No token or credential helper is configured for the operation.

fatal: could not read Username for 'https://github.com': terminal prompts
disabled

Diagnose it: depth, refs, or credentials?

git rev-parse --is-shallow-repository
git rev-parse --abbrev-ref HEAD    # prints HEAD when detached
git log --oneline -3
git remote -v

Common causes

No credential supplied for the HTTPS remote

The job never injected a token or configured a credential helper, so Git has no username/password and falls back to a prompt it cannot show.

Cross-repo operation without a token

The default workflow auth covers the current repo; a clone/push to another repo needs an explicit token that was not provided.

How to fix it

Embed a token in the remote URL

Authenticate non-interactively with an installation token (x-access-token) or a PAT.

git clone https://x-access-token:${GITHUB_TOKEN}@github.com/org/repo.git

Rewrite the host to carry the token

An insteadOf rewrite injects the credential for every HTTPS request to the host.

git config --global url."https://x-access-token:${GITHUB_TOKEN}@github.com/".insteadOf "https://github.com/"

Or let actions/checkout configure auth

On GitHub Actions, supply a token and let the action wire credentials.

- uses: actions/checkout@v4
  with:
    token: ${{ secrets.REPO_PAT }}

How to prevent it

• Always inject a token or configure a credential helper for HTTPS in CI.
• Provide an explicit token for cross-repo clones/pushes.
• Keep GIT_TERMINAL_PROMPT=0 so missing creds fail fast, not hang.

Frequently asked questions

Related guides

References

• Git reference manual
• GitHub Actions documentation