[FEATURE] Customisable welcome screen (image, title line, and startup tips)
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
The welcome screen shown on startup and after /clear is fixed. The image, title line ("Claude Code vx.x.x"), and tips section are all hardcoded. If you've set up a named assistant persona with a custom identity, rules files, and project context, the generic welcome screen feels disconnected from that setup. There's no way to make the startup experience reflect how you've actually configured the tool.
Proposed Solution
A few fields in settings.json to control the welcome screen. Something like welcomeMessage for the title line, welcomeImage for a custom image path, and welcomeTips for an array of strings to replace the default tips. That would let you show project context, a custom assistant name, or anything else relevant to your setup the moment a session starts.
Alternative Solutions
I tried using hooks on UserPromptSubmit to inject context, but that fires after the first message rather than on startup. It doesn't replace the welcome screen itself.
Priority
Low - Nice to have
Feature Category
Configuration and settings
Use Case Example
I've set up a persistent assistant persona with its own name, rules files, memory, and project handovers. When I start a session or use /clear, it'd be useful to see the assistant name instead of "Claude Code", a short state-of-play note in the tips area (current live projects, last session date), and optionally a custom image. Right now the welcome screen gives me nothing actionable. With these fields I'd get orientation before I've even typed anything.
Additional Context
_No response_
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗