Feature request: Allow basic customization of the welcome screen layout
Problem
Currently, Claude Code has two welcome screen layouts:
- Full dashboard (with Tips, Recent Activity panels) — shown when no
CLAUDE.mdexists - Compact mode (just version, model, directory) — shown when
CLAUDE.mdexists
There is no way to customize either layout. Users who prefer the full dashboard style (with border, structured panels) in an already-initialized project are stuck with the compact view.
Proposal
Add a welcomeStyle setting (in settings.json or via /config) with a few lightweight options:
| Option | Behavior |
|--------|----------|
| auto (default) | Current behavior — full dashboard for new projects, compact for initialized ones |
| compact | Always use the minimal view |
| dashboard | Always use the full bordered dashboard view |
This is not about redesigning the welcome screen — just letting users pick which existing layout they see, regardless of project state.
Example
// ~/.claude/settings.json
{
"welcomeStyle": "dashboard"
}
Why
The bordered dashboard layout looks cleaner and more organized. Some users prefer it as their default experience even in mature projects. A simple enum setting covers this without adding complexity.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗