[FEATURE] Ephemeral/Fresh Start Mode for Claude Code
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
When demonstrating Claude Code to new users, I want to show them the default out-of-the-box experience they'll encounter on first install. Currently, there's no simple way to temporarily run Claude Code without my accumulated configuration (skills, agents, hooks, MCP servers) interfering with the demo.
Proposed Solution
Introduce an ephemeral profile mode (e.g., claude --ephemeral or claude --demo) that:
- Starts with a clean, temporary configuration
- Allows installing skills, agents, and MCP servers within the session for demonstration purposes
- Discards all changes when the session ends
- Does not affect the user's actual configuration
Alternative Solutions
A simpler --fresh or --pristine flag that temporarily ignores all existing configuration (skills, agents, hooks, MCP servers, user/project settings) for that session only, without the ability to persist demo changes.
Priority
Medium - Would be very helpful
Feature Category
CLI commands and flags
Use Case Example
Scenario:
A developer wants to show a colleague how Claude Code works out-of-the-box, without their custom configuration affecting the experience.
Steps:
- Start ephemeral session
claude --ephemeral - Show default first-run experience
- Walk through the welcome prompts and initial setup
- Demonstrate basic commands and interactions as a new user would see them
- Do your full demonstration
- Exit the session
- All demo configuration (installed skills, settings) is automatically discarded
- Original user configuration remains untouched
- Resume normal work using
claude - Returns to full personal configuration with all skills, agents, and hooks intact
Additional Context
_No response_
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗