docs: document the CLI start screen freeze-animation setting - #479
Open
hongyi-chen wants to merge 2 commits into
Open
docs: document the CLI start screen freeze-animation setting#479hongyi-chen wants to merge 2 commits into
hongyi-chen wants to merge 2 commits into
Conversation
Document appearance.zero_state.freeze_animation_when_unfocused, which stops the Warp Agent CLI start screen animation from repainting while the terminal is unfocused. Co-Authored-By: Oz <oz-agent@warp.dev> Co-Authored-By: Warp Agent <agent@warp.dev>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
hongyi-chen
enabled auto-merge (squash)
August 5, 2026 19:24
Contributor
|
I'm starting a first review of this pull request. You can view the conversation on Warp. I completed the review and no human review was requested for this pull request. Comment Powered by Oz |
![oz-for-oss[bot]](https://avatars.githubusercontent.com/in/3450139?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Overview
This PR adds documentation for the appearance.zero_state.freeze_animation_when_unfocused CLI start screen setting, including its behavior, default, and hot-reload behavior.
Concerns
- No blocking concerns found.
Verdict
Found: 0 critical, 0 important, 0 suggestions
Approve
Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A
missing_docsdrift-watch run flaggedappearance.zero_state.freeze_animation_when_unfocusedas a new, undocumented setting. It's a GA (always_on), user-facing Warp Agent CLI setting, so it belongs alongside the otherappearance.zero_stateknobs on the CLI configuration page.Source of truth:
app/src/settings/tui_zero_state.rs(TuiZeroStateFreezeAnimationWhenUnfocusedSetting,SettingSurfaces::TUI, defaultfalse) andcrates/warp_tui/src/session.rs, which subscribes to the setting and applies it without a restart.Changes
src/content/docs/cli/configuration.mdx
freeze_animation_when_unfocusedto the Start screen settings list, noting that it stops repainting while the terminal window is unfocused, that it's off by default, and that changes apply as soon as you save.The surface-map entry pointing this setting at the CLI configuration page ships in the companion audit-bookkeeping PR.
Validation
npm run buildpasses.check_links.pyreports 0 broken links.Deferred findings from this audit run
Summarized in full in the companion audit-bookkeeping PR:
sync-openapi-specskill.--weak-coveragefindings, spot-checked as heuristic noise.Co-Authored-By: Oz oz-agent@warp.dev
Co-Authored-By: Warp Agent agent@warp.dev