Enhancement: Add --quiet mode for minimal output
Resolved 💬 3 comments Opened Oct 8, 2025 by gmelli Closed Oct 12, 2025
Enhancement Request: Add --quiet Mode for Minimal Output
Summary
Add a --quiet flag to suppress all narration and commentary, showing only tool calls and results.
Motivation
Power users running multi-step workflows want to see tool execution logs without explanatory narration. Current output includes unnecessary commentary before/after tool calls that clutters the terminal.
Proposed Solution
Option 1: CLI Flag
claude --quiet
# or
claude -q
Option 2: Setting
{
"alwaysThinkingEnabled": false,
"quietMode": true
}
Option 3: Permission Mode
claude --permission-mode quiet
Expected Behavior
Current (verbose):
⏺ I'll complete loading the context from the previous session...
⏺ Read(.aget/version.json)
⎿ Read 68 lines
⏺ I can see the previous session created documentation...
⏺ Bash(git status)
⎿ On branch main
⏺ Wind down complete.
Proposed (quiet):
⏺ Read(.aget/version.json)
⎿ Read 68 lines
⏺ Bash(git status)
⎿ On branch main
Scope
In quiet mode, suppress:
- Pre-action narration ("I'll...", "Let me...")
- Post-action commentary ("Wind down complete", "I can see...")
- Status updates between tool calls
Retain:
- Tool call logs (essential for transparency)
- Error explanations (when tools fail)
- Direct answers to user questions
- Final summaries when explicitly requested
Use Cases
- Automated workflows / CI/CD integration
- Power users familiar with tool patterns
- Terminal sessions with limited screen space
- Situations where token efficiency is critical
Alternative
Add to system instructions: "In default mode, suppress all narration around tool calls unless user explicitly requests explanations."
Related
- Issue #9128 (excessive narration bug report)
- Existing system instruction: "minimize output tokens as much as possible"
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗