aljaz/goose
1
0
Fork 0
mirror of https://github.com/aljazceru/goose.git synced 2025-12-17 22:24:21 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs: cli theme persistence (#3398)

Browse Source
This commit is contained in:
dianed-square
2025-07-14 06:28:41 -07:00
committed by GitHub
parent 9357933703
commit be2b2a3a44
3 changed files with 43 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
documentation/docs/guides/goose-cli-commands.md
View File

@@ -589,7 +589,8 @@ The CLI provides a set of slash commands that can be accessed during a session.
- `/prompts [--extension <n>]` - List all available prompts, optionally filtered by extension
- `/recipe <recipe file name>` - Generate and save a session recipe to `recipe.yaml` or the filename specified by the command parameter.
- `/summarize` - Summarize the current session to reduce context length while preserving key information
- `/t` - Toggle between Light/Dark/Ansi themes
- `/t` - Toggle between `light`, `dark`, and `ansi` themes
- `/t <theme>` - Set the `light`, `dark`, or `ansi` theme
All commands support tab completion. Press `<Tab>` after a slash (/) to cycle through available commands or to complete partial commands.
@@ -619,6 +620,40 @@ Goose CLI supports several shortcuts and built-in commands for easier navigation
### Slash Commands
- **`/exit` or `/quit`** - Exit the session
- **`/t`** - Toggle between Light/Dark/Ansi themes
- **`/t <theme>`** - Set theme directly (`/t light`, `/t dark`, or `/t ansi`)
- **`/t`** - Toggle between `light`, `dark`, and `ansi` themes
- **`/t <theme>`** - Set the `light`, `dark`, or `ansi` theme
- **`/?` or `/help`** - Display the help menu
### Themes
The `/t` command controls the syntax highlighting theme for markdown content in Goose CLI responses. This affects the styles used for headers, code blocks, bold/italic text, and other markdown elements in the response output.
**Commands:**
- `/t` - Cycles through themes: `light` → `dark` → `ansi` → `light`
- `/t light` - Sets `light` theme (subtle light colors)
- `/t dark` - Sets `dark` theme (subtle darker colors)
- `/t ansi` - Sets `ansi` theme (most visually distinct option with brighter colors)
**Configuration:**
- The default theme is `dark`
- The theme setting is saved to the [configuration file](/docs/guides/config-file) as `GOOSE_CLI_THEME` and persists between sessions
- The saved configuration can be overridden for the session using the `GOOSE_CLI_THEME` [environment variable](/docs/guides/environment-variables#session-management)
:::info
Syntax highlighting styles only affect the font, not the overall terminal interface. The `light` and `dark` themes have subtle differences in font color and weight.
The Goose CLI theme is independent from the Goose Desktop theme.
:::
**Examples:**
```bash
# Set ANSI theme for the session via environment variable
export GOOSE_CLI_THEME=ansi
goose session --name use-custom-theme
# Toggle theme during a session
/t
# Set the light theme during a session
/t light
```