Skip to content

docs: add CLI syntax highlighting theme customization#7324

Merged
blackgirlbytes merged 2 commits intomainfrom
docs/cli-syntax-highlighting-themes
Feb 18, 2026
Merged

docs: add CLI syntax highlighting theme customization#7324
blackgirlbytes merged 2 commits intomainfrom
docs/cli-syntax-highlighting-themes

Conversation

@blackgirlbytes
Copy link
Contributor

@blackgirlbytes blackgirlbytes commented Feb 18, 2026

Summary

Documents the new GOOSE_CLI_LIGHT_THEME and GOOSE_CLI_DARK_THEME environment variables that allow users to customize the bat themes used for syntax highlighting in goose CLI output.

Changes

  • environment-variables.md: Added new variables to Session Management table with examples
  • config-files.md: Added new variables to config options table
  • goose-cli-commands.md: Added "Custom Syntax Highlighting" section under Themes

Details

Users can now set custom bat themes for syntax highlighting:

Variable Purpose Default
GOOSE_CLI_LIGHT_THEME Theme for light mode "GitHub"
GOOSE_CLI_DARK_THEME Theme for dark mode "zenburn"

Popular theme options include: Dracula, Nord, Solarized (light/dark), OneHalfDark, Monokai Extended.

Related

Closes documentation for #7140

@blackgirlbytes
docs: add CLI syntax highlighting theme customization
09f7063 
Document the new GOOSE_CLI_LIGHT_THEME and GOOSE_CLI_DARK_THEME
environment variables that allow users to customize the bat themes
used for syntax highlighting in goose CLI output.

Updates:
- environment-variables.md: Add new variables to Session Management table with examples
- config-files.md: Add new variables to config options table
- goose-cli-commands.md: Add Custom Syntax Highlighting section under Themes

Related to: #7140
@blackgirlbytes blackgirlbytes requested a review from a team as a code owner February 18, 2026 21:38
Copilot AI review requested due to automatic review settings February 18, 2026 21:38
Copilot AI reviewed Feb 18, 2026
View reviewed changes
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR documents two new environment variables (GOOSE_CLI_LIGHT_THEME and GOOSE_CLI_DARK_THEME) that allow users to customize syntax highlighting themes in the goose CLI using bat themes. The documentation is added to support the feature implemented in PR #7140.

Changes:

  • Added documentation for GOOSE_CLI_LIGHT_THEME and GOOSE_CLI_DARK_THEME to environment variables and config files reference
  • Added "Custom Syntax Highlighting" section to goose CLI commands guide with examples and popular theme options
  • Included usage examples showing how to set custom bat themes

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
documentation/docs/guides/environment-variables.md Added new variables to Session Management table with descriptions, examples, and default values
documentation/docs/guides/config-files.md Added new variables to Global Settings table for config file reference
documentation/docs/guides/goose-cli-commands.md Added "Custom Syntax Highlighting" section under Themes with usage details and popular theme options

@github-actions
Copy link
Contributor

github-actions bot commented Feb 18, 2026 •
edited
Loading

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://block.github.io/goose/pr-preview/pr-7324/

Built to branch gh-pages at 2026-02-18 21:45 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@blackgirlbytes
fix: update bat theme links to working URL
3b5aebd 
Change links from non-existent /blob/master/doc/themes.md to
the working #adding-new-themes anchor in the main README.
Also added tip to run 'bat --list-themes' to see available themes.
@blackgirlbytes blackgirlbytes added this pull request to the merge queue Feb 18, 2026
Merged via the queue into main with commit 5ce0008 Feb 18, 2026
22 checks passed
@blackgirlbytes blackgirlbytes deleted the docs/cli-syntax-highlighting-themes branch February 18, 2026 22:05
michaelneale added a commit that referenced this pull request Feb 19, 2026
@michaelneale
Merge branch 'main' into gateway-abstraction
0e40303 
* main: (54 commits)
  docs: add monitoring subagent activity section (#7323)
  docs: document Desktop UI recipe editing for model/provider and extensions (#7327)
  docs: add CLAUDE_THINKING_BUDGET and CLAUDE_THINKING_ENABLED environm… (#7330)
  fix: display 'Code Mode' instead of 'code_execution' in CLI (#7321)
  docs: add Permission Policy documentation for MCP Apps (#7325)
  update RPI plan prompt (#7326)
  docs: add CLI syntax highlighting theme customization (#7324)
  fix(cli): replace shell-based update with native Rust implementation (#7148)
  docs: rename Code Execution extension to Code Mode extension (#7316)
  docs: remove ALPHA_FEATURES flag from documentation (#7315)
  docs: escape variable syntax in recipes (#7314)
  docs: update OTel environment variable and config guides (#7221)
  docs: system proxy settings (#7311)
  docs: add Summon extension tutorial and update Skills references (#7310)
  docs: agent session id (#7289)
  fix(gemini-cli): restore streaming lost in #7247 (#7291)
  Update more instructions (#7305)
  feat: add Moonshot and Kimi Code declarative providers (#7304)
  fix(cli): handle Reasoning content and fix streaming thinking display (#7296)
  feat: add GOOSE_SUBAGENT_MODEL and GOOSE_SUBAGENT_PROVIDER config options (#7277)
  ...
katzdave added a commit that referenced this pull request Feb 19, 2026
@katzdave
Merge branch 'main' of github.com:block/goose into dkatz/models-custom
0382e69 
* 'main' of github.com:block/goose: (40 commits)
  Remove trailing space from links (#7156)
  fix: detect low balance and prompt for top up (#7166)
  feat(apps): add support for MCP apps to sample (#7039)
  Typescript SDK for ACP extension methods (#7319)
  chore: upgrade to rmcp 0.16.0 (#7274)
  docs: add monitoring subagent activity section (#7323)
  docs: document Desktop UI recipe editing for model/provider and extensions (#7327)
  docs: add CLAUDE_THINKING_BUDGET and CLAUDE_THINKING_ENABLED environm… (#7330)
  fix: display 'Code Mode' instead of 'code_execution' in CLI (#7321)
  docs: add Permission Policy documentation for MCP Apps (#7325)
  update RPI plan prompt (#7326)
  docs: add CLI syntax highlighting theme customization (#7324)
  fix(cli): replace shell-based update with native Rust implementation (#7148)
  docs: rename Code Execution extension to Code Mode extension (#7316)
  docs: remove ALPHA_FEATURES flag from documentation (#7315)
  docs: escape variable syntax in recipes (#7314)
  docs: update OTel environment variable and config guides (#7221)
  docs: system proxy settings (#7311)
  docs: add Summon extension tutorial and update Skills references (#7310)
  docs: agent session id (#7289)
  ...
jh-block added a commit that referenced this pull request Feb 19, 2026
@jh-block
Merge remote-tracking branch 'origin/main' into local-models-candle
2ddc657 
* origin/main:
  fix(ci): deflake smoke tests for Google models (#7344)
  feat: add Cerebras provider support (#7339)
  fix: skip whitespace-only text blocks in Anthropic message (#7343)
  fix(goose-acp): heap allocations (#7322)
  Remove trailing space from links (#7156)
  fix: detect low balance and prompt for top up (#7166)
  feat(apps): add support for MCP apps to sample (#7039)
  Typescript SDK for ACP extension methods (#7319)
  chore: upgrade to rmcp 0.16.0 (#7274)
  docs: add monitoring subagent activity section (#7323)
  docs: document Desktop UI recipe editing for model/provider and extensions (#7327)
  docs: add CLAUDE_THINKING_BUDGET and CLAUDE_THINKING_ENABLED environm… (#7330)
  fix: display 'Code Mode' instead of 'code_execution' in CLI (#7321)
  docs: add Permission Policy documentation for MCP Apps (#7325)
  update RPI plan prompt (#7326)
  docs: add CLI syntax highlighting theme customization (#7324)
  fix(cli): replace shell-based update with native Rust implementation (#7148)
  docs: rename Code Execution extension to Code Mode extension (#7316)
aharvard added a commit that referenced this pull request Feb 19, 2026
@aharvard
Merge remote-tracking branch 'origin/main' into aharvard/display-modes
64fc7a4 
* origin/main: (29 commits)
  fix(ci): deflake smoke tests for Google models (#7344)
  feat: add Cerebras provider support (#7339)
  fix: skip whitespace-only text blocks in Anthropic message (#7343)
  fix(goose-acp): heap allocations (#7322)
  Remove trailing space from links (#7156)
  fix: detect low balance and prompt for top up (#7166)
  feat(apps): add support for MCP apps to sample (#7039)
  Typescript SDK for ACP extension methods (#7319)
  chore: upgrade to rmcp 0.16.0 (#7274)
  docs: add monitoring subagent activity section (#7323)
  docs: document Desktop UI recipe editing for model/provider and extensions (#7327)
  docs: add CLAUDE_THINKING_BUDGET and CLAUDE_THINKING_ENABLED environm… (#7330)
  fix: display 'Code Mode' instead of 'code_execution' in CLI (#7321)
  docs: add Permission Policy documentation for MCP Apps (#7325)
  update RPI plan prompt (#7326)
  docs: add CLI syntax highlighting theme customization (#7324)
  fix(cli): replace shell-based update with native Rust implementation (#7148)
  docs: rename Code Execution extension to Code Mode extension (#7316)
  docs: remove ALPHA_FEATURES flag from documentation (#7315)
  docs: escape variable syntax in recipes (#7314)
  ...

# Conflicts:
#	ui/desktop/src/components/McpApps/McpAppRenderer.tsx
#	ui/desktop/src/components/McpApps/types.ts
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@angiejones angiejones angiejones approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@blackgirlbytes @angiejones

Comments