Skip to content

docs: document the CLI start screen freeze-animation setting #479

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
hongyi-chen wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: document the CLI start screen freeze-animation setting #479

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
92047de
docs: document the CLI start screen freeze-animation setting
hongyi-chen Aug 5, 2026
f0af1e1
Merge branch 'main' into docs/cli-start-screen-freeze-animation
hongyi-chen Aug 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions src/content/docs/cli/configuration.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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".

Expand Down
Loading