Feature: Visual prompt state indicators (working/waiting/done/error)
Summary
When using Claude Code, the prompt looks the same regardless of what state the system is in. It's difficult to tell at a glance whether Claude Code is:
- Still working in the background
- Finished and idle
- Waiting for user input/action
- Waiting for tool permission
- Stopped/idle
- Blocked by an error
Proposal
Add visual state indicators to the prompt (e.g., distinct icons/emojis) that change based on the current state of Claude Code. This would provide immediate visual feedback without needing to read output.
Proposed states (6)
| State | Description |
|-------|-------------|
| Working | Claude is processing, running tools, or generating output |
| Done | Task completed, ready for next input |
| Waiting for user | Claude asked a question or needs user decision |
| Waiting for permission | A tool requires user approval before executing |
| Idle/Stopped | No active task, prompt is ready |
| Error/Blocked | Something went wrong, needs attention |
Visual approach
Each state should have a distinct icon/emoji prefixed to the prompt character, making the current state immediately recognizable. The specific icons should be chosen by the team for consistency with the existing UI.
Example (illustrative)
⏳ > # Working in background
✅ > # Done
❓ > # Waiting for user input
🔐 > # Waiting for tool permission
> > # Idle (default)
❌ > # Error/blocked
Motivation
During long-running tasks or multi-step workflows, I frequently find myself unsure whether Claude Code is still processing or waiting for me. This is especially confusing when:
- Background agents are running
- Claude is waiting for tool approval
- A task silently failed
A simple visual indicator would save time and reduce confusion.
This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗