Skip to content

fix: correct pager default to false as intended by PR #1430#1642

Merged
osterman merged 7 commits intomainfrom
osterman/fix-pager-default
Oct 16, 2025
Merged

fix: correct pager default to false as intended by PR #1430#1642
osterman merged 7 commits intomainfrom
osterman/fix-pager-default

Conversation

@osterman
Copy link
Member

@osterman osterman commented Oct 16, 2025

what

why

  • PR fix: disable pager mouse interactions and add global --pager flag #1430 (commit 08a44dd) documented a BREAKING CHANGE: "Pager is now disabled by default"
  • However, the actual default value in setDefaultConfiguration() was never changed from true to false
  • This caused the pager to remain enabled by default for users without explicit pager: false in their atmos.yaml
  • The repository's own atmos.yaml has pager: false which masked the issue locally

references

Summary by CodeRabbit

  • Changes

    • Terminal pager is now disabled by default so command output displays directly in the terminal for easier piping, copying, and quick scanning.
    • You can re-enable paging via configuration, a CLI flag, or an environment variable.
  • Bug Fixes

    • Removed an extraneous debug message from CLI stderr to reduce noise.
  • Documentation

    • Added a blog post explaining the pager default correction, impact, and how to opt back in.

@osterman osterman requested a review from a team as a code owner October 16, 2025 02:23
@github-actions github-actions bot added the size/xs Extra small size PR label Oct 16, 2025
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Oct 16, 2025

📝 Walkthrough

Walkthrough

Default CLI configuration changed: settings.terminal.pager now defaults to false. Test snapshots were updated to reflect the new default and a removed debug line. A blog post documenting the pager default correction was added.

Changes

Cohort / File(s) Summary
Config defaults
pkg/config/load.go
Changed default for settings.terminal.pager from true to false in setDefaultConfiguration.
Test snapshots
tests/snapshots/TestCLICommands_atmos_describe_configuration.stdout.golden, tests/snapshots/TestCLICommands_atmos_describe_configuration.stderr.golden
Updated stdout snapshot to show terminal.pager as 0 instead of 1; removed a DEBU Failed to use pager line from the stderr snapshot.
Website / docs
website/blog/2025-10-15-pager-default-correction.md
Added blog post explaining the pager default correction, impact, and how to opt into paging (config/CLI/env).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested labels

patch, tests, docs

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The title clearly summarizes the primary change by stating the correction of the pager default to false and uses the conventional “fix:” prefix while referencing the original PR for context, all in a concise single sentence that directly aligns with the changeset.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch osterman/fix-pager-default

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 9d75d92 and f52239d.

📒 Files selected for processing (1)
  • website/blog/2025-10-15-pager-default-correction.md (1 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
website/**

📄 CodeRabbit inference engine (.cursor/rules/atmos-rules.mdc)

website/**: Update website documentation in website/ when adding features
Ensure consistency between CLI help text and website documentation
Follow the website's documentation structure and style
Keep website code in website/ and follow its architecture/style; test changes locally
Keep CLI and website documentation in sync; document new features with examples and use cases

Files:

  • website/blog/2025-10-15-pager-default-correction.md
🪛 LanguageTool
website/blog/2025-10-15-pager-default-correction.md

[style] ~16-~16: ‘with the intention of’ might be wordy. Consider a shorter alternative.
Context: ... in September 2025, PR #1430 was merged with the intention of changing this default to improve the sc...

(EN_WORDINESS_PREMIUM_WITH_THE_INTENTION_OF)


[grammar] ~18-~18: There might be a mistake here.
Context: ... PR included: - A global --pager flag - Support for the NO_PAGER environment v...

(QB_NEW_EN)


[grammar] ~19-~19: There might be a mistake here.
Context: ... for the NO_PAGER environment variable - Documentation stating: "**BREAKING CHANG...

(QB_NEW_EN)


[typographical] ~20-~20: Consider using a typographic opening quote here.
Context: ...nment variable - Documentation stating: "BREAKING CHANGE: Pager is now disabl...

(EN_QUOTES)


[typographical] ~20-~20: Consider using a typographic close quote here.
Context: ...ANGE**: Pager is now disabled by default" However, the actual default value in t...

(EN_QUOTES)


[grammar] ~82-~82: There might be a mistake here.
Context: ...s - PR #1642: Pager Default Correction - [Original PR #1430: Pager Improvements](h...

(QB_NEW_EN)


[grammar] ~83-~83: There might be a mistake here.
Context: ...- Original PR #1430: Pager Improvements - [Terminal Configuration Documentation](/c...

(QB_NEW_EN)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (6)
  • GitHub Check: Build (ubuntu-latest, linux)
  • GitHub Check: Build (windows-latest, windows)
  • GitHub Check: Lint (golangci)
  • GitHub Check: Analyze (go)
  • GitHub Check: website-deploy-preview
  • GitHub Check: Summary

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

coderabbitai[bot]
coderabbitai bot previously approved these changes Oct 16, 2025
aknysh
aknysh previously approved these changes Oct 16, 2025
@osterman osterman added the patch A minor, backward compatible change label Oct 16, 2025
Update test snapshots to reflect the corrected pager default value:
- Change pager from "1" (true) to "0" (false) in describe configuration output
- Remove "Failed to use pager" debug message from stderr (pager is now disabled by default)

These changes align with the fix in the previous commit where the pager
default was corrected to false as originally intended by PR #1430.
@osterman osterman dismissed stale reviews from aknysh and coderabbitai[bot] via 313ee61 October 16, 2025 02:43
coderabbitai[bot]
coderabbitai bot previously approved these changes Oct 16, 2025
@codecov
Copy link

codecov bot commented Oct 16, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 65.02%. Comparing base (ba4a2de) to head (714c8be).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main    #1642      +/-   ##
==========================================
+ Coverage   64.97%   65.02%   +0.04%     
==========================================
  Files         338      338              
  Lines       37535    37535              
==========================================
+ Hits        24388    24406      +18     
+ Misses      11201    11182      -19     
- Partials     1946     1947       +1     
Flag Coverage Δ
unittests 65.02% <100.00%> (+0.04%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines Coverage Δ
pkg/config/load.go 80.17% <100.00%> (ø)

... and 3 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Add blog post explaining the regression and its fix:
- Describes the history of the pager default issue
- Explains impact on users
- Provides migration guide for those who relied on pager being enabled
- Links to relevant PRs and documentation

This blog post helps users understand why the pager behavior may have
changed and how to re-enable it if desired.
@github-actions github-actions bot added size/s Small size PR and removed size/xs Extra small size PR labels Oct 16, 2025
coderabbitai[bot]
coderabbitai bot previously approved these changes Oct 16, 2025
Change documentation link from /cli/configuration/settings#terminal-settings
to /cli/configuration/terminal to fix broken link in blog post.
@osterman osterman merged commit 87ac398 into main Oct 16, 2025
54 checks passed
@osterman osterman deleted the osterman/fix-pager-default branch October 16, 2025 16:57
@github-actions
Copy link

These changes were released in v1.195.0-test.0.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

patch A minor, backward compatible change size/s Small size PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants