Feature Request: Configurable Pager Support for Claude Code Text Summaries

Feature Request: Configurable Pager Support for Claude Code Text Summaries

Summary

Add option to automatically open Claude Code's text summaries and outputs in a user-configurable pager (less, glow, bat, etc.) for improved readability and navigation.

Description

Claude Code currently outputs text summaries directly to the terminal, which can be challenging to read for longer outputs. This feature would allow users to configure their preferred pager to automatically display summaries, providing better navigation, syntax highlighting, and reading experience.

Proposed Implementation

Configuration:

# Set default pager
claude code config set pager less
claude code config set pager glow
claude code config set pager bat

# Or via environment variable
export CLAUDE_CODE_PAGER=glow

Command Options:

# Use configured pager for this session
claude code --pager

# Override pager for specific command
claude code --pager=bat "refactor this codebase"

# Disable pager temporarily
claude code --no-pager

Supported Pagers

• less - Standard Unix pager with search and navigation
• glow - Markdown rendering with styled output
• bat - Syntax highlighting with git integration
• most - Enhanced pager with multi-window support
• Custom - Any command that accepts piped input

Configuration Options

# .claude-code/config.yml
pager:
  command: "glow"
  args: ["--style", "dark", "--width", "100"]
  enabled: true
  min_lines: 20  # Only use pager if output exceeds this

Benefits

1. Improved Readability - Better formatting for long summaries
2. Navigation - Search, scroll, and jump through content easily
3. Syntax Highlighting - Enhanced code snippet visibility (bat, glow)
4. Markdown Rendering - Properly styled markdown output (glow)
5. User Preference - Respects individual workflow preferences

Use Cases

• Reviewing detailed refactoring summaries
• Reading long explanation of changes
• Navigating through multi-file modification reports
• Searching within Claude's explanations
• Better code snippet visibility in summaries

Technical Considerations

• Graceful fallback if configured pager is not available
• Detect terminal capabilities (TTY vs pipe)
• Preserve ANSI colors when appropriate
• Handle binary/non-text content appropriately
• Respect user's existing PAGER environment variable as default

Additional Features

• Auto-detect optimal pager based on content type (markdown → glow, code → bat)
• Option to save pager output to file
• Integration with terminal multiplexers (tmux/screen)
• Smart line counting to avoid pager for short outputs
• Support for pager-specific features (e.g., bat's diff highlighting)

Example Workflow

# Configure once
claude code config set pager glow

# All subsequent summaries open in glow
claude code "implement authentication system"
# Summary automatically opens in glow with styled markdown

# Override for specific task
claude code --pager=bat "analyze this Python module"
# Output opens in bat with syntax highlighting

---

This feature would significantly improve the user experience when working with Claude Code's detailed outputs, making long summaries more digestible and easier to navigate.