From 92047dee55f275047ef8532dd98dcd42a4952306 Mon Sep 17 00:00:00 2001 From: hongyi-chen Date: Wed, 5 Aug 2026 17:17:48 +0000 Subject: [PATCH] docs: document the CLI start screen freeze-animation setting 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 Co-Authored-By: Warp Agent --- src/content/docs/cli/configuration.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/src/content/docs/cli/configuration.mdx b/src/content/docs/cli/configuration.mdx index 7da7bb846..0c9414390 100644 --- a/src/content/docs/cli/configuration.mdx +++ b/src/content/docs/cli/configuration.mdx @@ -106,6 +106,7 @@ The start screen appears when you launch the CLI, showing a rotating ASCII objec * **`object`** - The rotating object. Keep the built-in one, or point the setting at your own ASCII art file (a path relative to the CLI settings directory). Changing the setting reloads the object. Edits to the linked file take effect after a restart. * **`rotation_period_seconds`** - Seconds per full rotation, from 1 through 60. * **`show_signed_in_user`, `show_changelog`, `show_project_info`, `show_mcp`, `show_animation`** - Toggle individual start-screen sections. +* **`freeze_animation_when_unfocused`** - Stop repainting the animation while your terminal window is unfocused, so an idle start screen doesn't use CPU in the background. Off by default, and applied as soon as you save the setting. The fastest way to change these is to [ask the agent](#ask-the-agent), for example "use my own ASCII art for the start screen object".