claude-code - 💡(How to fix) Fix Task switcher 'main'/'fork' labels collide with git terminology [1 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#55103Fetched 2026-05-01 05:46:12
View on GitHub
Comments
0
Participants
1
Timeline
6
Reactions
0
Author
Participants
Timeline (top)
labeled ×5unlabeled ×1

Error Message

Error Messages/Logs

Root Cause

The collision is worse because:

  1. The labels appear in green/uncolored text with no other context — there's no icon or qualifier hinting "conversation thread" vs "git branch."
  2. The agent footer says accept edits on immediately above, which primes the user to think about edits + branches.
  3. By the time the user realizes the words mean something else, they've
    already done the worst-case mental math.
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?

What happened

I was working with Claude in a git repo, on a feature branch
(feature/multilingual, branched off main). Claude was making edits to a file in that working tree, and had also spawned a backgrounded subagent for a
parallel research task. When I opened the task switcher (↓ to manage), I saw this:

<img width="957" height="130" alt="Image" src="https://github.com/user-attachments/assets/64742723-6932-4ad0-acde-023e8bdb2496" />

Two threads labeled main and fork. My immediate read — given that I'm in a git repo and was actively thinking about branches — was "Claude is making edits on the main git branch instead of my feature branch." That sent me into a
panic that committed work was being polluted on the protected branch.

It wasn't true. The labels mean:

  • main = the primary Claude Code conversation thread
  • fork = a spawned parallel agent thread

The actual git branch checked out was feature/multilingual the entire time, and edits were correctly landing in that working tree. But by the time Claude explained the terminology, several minutes of trust damage had already happened.

Why it's confusing

main and fork are loaded git terms. In a git context, "main" specifically
denotes the protected default branch and "fork" denotes a derivative branch/repo. Using those exact words for an unrelated concept (parallel
conversation threads) inside a tool whose primary use case is editing code in git repos is a near-certain misread for any user glancing at the UI without reading docs.

The collision is worse because:

  1. The labels appear in green/uncolored text with no other context — there's no icon or qualifier hinting "conversation thread" vs "git branch."
  2. The agent footer says accept edits on immediately above, which primes the user to think about edits + branches.
  3. By the time the user realizes the words mean something else, they've
    already done the worst-case mental math.

What Should Happen?

Suggested fixes (ranked)

  1. Rename main → primary (or chat, or you) and fork → agent (or subagent, or
    background). These don't collide with git nouns.
  2. If the labels stay, prefix them with an icon/word that disambiguates ("💬
    main" vs "🌿 main" — or just always show the actual git branch in the same
    line).
  3. At minimum, surface a one-time tooltip or help-on-first-use explaining the terminology.

Repro

  1. Be in a git repo on any non-main branch.
  2. Have Claude spawn a subagent (any Agent tool call without subagent_type set, or with one).
  3. Open the task switcher (↓ to manage).
  4. Observe main and fork labels.

Environment

  • Claude Code CLI (interactive)
  • macOS

Error Messages/Logs

Steps to Reproduce

Kick off a task that spawns two agents.

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

No response

Claude Code Version

2.1.123

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

extent analysis

TL;DR

Renaming the "main" and "fork" labels in the task switcher to more descriptive terms, such as "primary" and "agent", can help avoid confusion with Git terminology.

Guidance

  • The current labeling of "main" and "fork" in the task switcher is likely to cause confusion for users familiar with Git, as these terms have specific meanings in the context of version control.
  • To mitigate this issue, consider adding a prefix or icon to the labels to disambiguate them from Git branches, such as "💬 main" or "🌿 main".
  • Alternatively, displaying the actual Git branch in the same line as the task switcher labels could also help clarify the meaning of "main" and "fork" in this context.
  • A one-time tooltip or help-on-first-use explanation of the terminology could also be implemented to educate users on the intended meaning of these labels.

Example

No code snippet is provided as the issue is related to UI labeling and terminology.

Notes

The suggested fixes are ranked in the issue report, with renaming the labels being the top suggestion. The issue is reported to be a regression, meaning it worked in a previous version, but the last working version is not specified.

Recommendation

Apply workaround: Rename the labels to more descriptive terms, such as "primary" and "agent", to avoid confusion with Git terminology. This is a simple and effective solution that can help prevent user confusion and mistrust.

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

claude-code - 💡(How to fix) Fix Task switcher 'main'/'fork' labels collide with git terminology [1 participants]