claude-code - 💡(How to fix) Fix [FEATURE] Allow custom display name for projects in sidebar / picker [2 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#52144Fetched 2026-04-23 07:35:28
View on GitHub
Comments
2
Participants
2
Timeline
4
Reactions
1
Timeline (top)
commented ×2labeled ×2
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing requests and this feature hasn't been requested yet
  • This is a single feature request (not multiple features)

Problem Statement

Today the sidebar / project picker label is derived from the working directory's folder name. There's no setting to override it.

Proposed Solution

Request: a displayName (or similar) field in .claude/settings.json or ~/.claude/settings.json that, when set, overrides the folder-derived label in:

  • the recent-projects sidebar
  • the session/task picker
  • anywhere else the project label is rendered

Alternative Solutions

Falls back to the folder name when unset (current behavior).

Priority

Medium - Would be very helpful

Feature Category

Configuration and settings

Use Case Example

Use case: my repo lives at ~/Documents/PROJECT-NAME but the project is called "PROJECT_NAME-GITHUB" — I don't want to rename the folder (it would break local scripts, IDE bookmarks, deploy aliases) just to clean up the sidebar label.

Additional Context

❤️ thanks for making Claude

extent analysis

TL;DR

Add a displayName field to the .claude/settings.json or ~/.claude/settings.json file to override the folder-derived label in the sidebar and project picker.

Guidance

  • Consider adding a new field to the existing settings JSON files to store the custom display name for the project.
  • Verify that the proposed solution works by checking if the custom display name is correctly rendered in the recent-projects sidebar, session/task picker, and other relevant areas.
  • Ensure that the fallback behavior to the folder name works when the displayName field is unset.
  • Review the code to determine the best way to integrate the new displayName field with the existing logic for deriving the project label from the folder name.

Example

No code example is provided as the issue does not contain sufficient technical details about the implementation.

Notes

The proposed solution assumes that the .claude/settings.json and ~/.claude/settings.json files are already being read and used by the application. The implementation details of how to integrate the new displayName field with the existing codebase are not provided.

Recommendation

Apply workaround: Add a displayName field to the settings JSON file, as this provides a flexible and non-intrusive way to override the default project label without modifying the underlying folder structure.

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 [FEATURE] Allow custom display name for projects in sidebar / picker [2 comments, 2 participants]