claude-code - 💡(How to fix) Fix [BUG] Ultraplan: Background tasks require a git repository despite valid git repo, remote, and GitHub app installed [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#46883Fetched 2026-04-12 13:30:32
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Timeline (top)
labeled ×3commented ×1

Error Message

  • Error: always shows "Background tasks require a git repository. Initialize git or run from a git repository."

Error Messages/Logs

  1. Once you get the error that its not a git repository, initialize the git repo.
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

  • Claude Code version: 2.1.104
  • Repo: public GitHub repo with commits, remote tracking branch set, GitHub Claude App installed
  • Error: always shows "Background tasks require a git repository. Initialize git or run from a git repository."
  • Tried: git init, git push -u origin main, GitHub App installation at https://github.com/apps/claude/installations/new
  • All local git checks pass: worktrees work, rev-parse --show-toplevel returns correct path, remote is configured

What Should Happen?

Launch ultraplan on /ultraplan prompt

Error Messages/Logs

Steps to Reproduce

  1. Create a plan for an app in claude terminal
  2. Make sure initially its not a git repository
  3. Ask the claude to refine the plan using /ultraplan
  4. Launch ultraplan
  5. Once you get the error that its not a git repository, initialize the git repo.
  6. Make your git repo public and install claude
  7. Try launching ultraplan again

Claude Model

Sonnet (default)

Is this a regression?

No, this never worked

Last Working Version

No response

Claude Code Version

2.1.104

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

extent analysis

TL;DR

The issue can be resolved by ensuring the Claude Code is properly configured to recognize the git repository, potentially by re-installing the GitHub App or re-initializing the git repository after installing the app.

Guidance

  • Verify that the git repository is correctly initialized and configured after installing the GitHub App, as the error message suggests that Claude Code is not recognizing the repository.
  • Try re-installing the GitHub App or re-configuring the git repository to ensure that Claude Code can properly access it.
  • Check the repository settings to ensure that the Claude App has the necessary permissions to access the repository.
  • Ensure that the rev-parse --show-toplevel command returns the correct path to the git repository, as this may indicate a configuration issue.

Example

No specific code snippet is provided, as the issue appears to be related to configuration and setup rather than code.

Notes

The issue may be related to the order of operations, as the user is initializing the git repository after attempting to launch ultraplan. Ensuring that the repository is properly set up before attempting to use Claude Code may resolve the issue.

Recommendation

Apply workaround: Re-install the GitHub App and re-initialize the git repository to ensure proper configuration and access. This may resolve the issue by ensuring that Claude Code can properly recognize and access the repository.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING