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"

View original on GitHub ↗

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