From a9eb5d3700f8b8fdff3052a0490429cd09993d45 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Arnaud=20H=C3=A9ritier?= Date: Sat, 30 May 2026 04:02:10 +0000 Subject: [PATCH] docs: document --theme flag for docker agent run (refs #2933) --- docs/features/cli/index.md | 2 ++ docs/features/tui/index.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs/features/cli/index.md b/docs/features/cli/index.md index 65c500974..2b5177336 100644 --- a/docs/features/cli/index.md +++ b/docs/features/cli/index.md @@ -37,6 +37,7 @@ $ docker agent run [config] [message...] [flags] | `--dry-run` | Initialize the agent without executing anything (useful for validating a config) | | `--remote ` | Use a remote runtime at the given address instead of running the agent locally | | `--lean` | Use a simplified TUI with minimal chrome | +| `--theme ` | Preselect a TUI theme by name at launch (overrides `settings.theme` in user config; ignored in `--exec` mode). Run `/theme` to browse available names. | | `--app-name ` | Override the application name label shown in the TUI (status bar, window title, "/exit" notifications). | | `--sidebar` | Control sidebar visibility. Set to `--sidebar=false` to hide the sidebar and disable the Ctrl+B toggle (default: `true`). | | `--disable-commands ` | Hide and disable specific slash commands in the TUI. Accepts a comma-separated list of command names (leading slash optional, case-insensitive). E.g. `--disable-commands="/cost,/eval,/model"`. | @@ -82,6 +83,7 @@ $ docker agent run agent.yaml --hook-pre-tool-use "./scripts/validate.sh" --hook $ docker agent run agent.yaml "question 1" "question 2" "question 3" # Customize TUI display +$ docker agent run agent.yaml --theme dracula $ docker agent run agent.yaml --app-name "My Project" $ docker agent run agent.yaml --sidebar=false $ docker agent run agent.yaml --disable-commands="/cost,/eval,/model" diff --git a/docs/features/tui/index.md b/docs/features/tui/index.md index dc7c305f8..85ce23b2b 100644 --- a/docs/features/tui/index.md +++ b/docs/features/tui/index.md @@ -261,6 +261,8 @@ settings: theme: my-theme # References ~/.cagent/themes/my-theme.yaml ``` +**At launch:** Pass `--theme ` to `docker agent run` to preselect a theme for that session. This overrides `settings.theme` in your config but is not saved. Invalid theme names print an error at startup listing the available options. Has no effect in `--exec` mode. + **At runtime:** Use the `/theme` command to open the theme picker and select from available themes. Your selection is saved globally in `~/.config/cagent/config.yaml` under `settings.theme` and persists across sessions.