[FEATURE] Allow custom display name for projects in sidebar / picker

Resolved 💬 3 comments Opened Apr 22, 2026 by josh-airwave Closed May 28, 2026

Preflight Checklist

  • [x] I have searched existing requests and this feature hasn't been requested yet
  • [x] 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

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗