Feature: Visual prompt state indicators (working/waiting/done/error)

Open 💬 6 comments Opened Jan 30, 2026 by theodari

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.

View original on GitHub ↗

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