Add Theme docs (#753)

docs/architecture.md

@@ -13,7 +13,7 @@ The Gemini CLI is primarily composed of two main packages, along with a suite of
       - Input processing (parsing commands, text prompts).
       - History management.
       - Display rendering (including Markdown, code highlighting, and tool messages).
-      - Theme and UI customization.
+      - [Theme and UI customization](./cli/themes.md).
       - Communication with the Core package.
       - Manages user configuration settings specific to the CLI.
 

docs/cli/commands.md

@@ -16,7 +16,7 @@ Slash commands provide meta-level control over the CLI itself. They can typicall
   - **Description:** Clears the entire terminal screen, including the visible session history and scrollback within the CLI.
   - **Action:** Wipes the terminal display. The underlying session data (for history recall) might be preserved depending on the exact implementation, but the visual display is cleared.
 
-- **`/theme`**
+- [**`/theme`**](./themes.md)
 
   - **Description:** Allows you to change the visual theme of the Gemini CLI.
   - **Action:** Opens a dialog or prompt to select from available themes.

docs/cli/index.md

@@ -14,7 +14,7 @@ The Gemini CLI (`packages/cli`) is the primary way users interact with the Gemin
   - Syntax highlighting for code blocks in various languages.
   - Clear display of tool calls, inputs, and outputs.
 - **Command History:** Easily access and re-run previous commands and prompts.
-- **Theming:** Customize the look and feel of the CLI to your preference. See the [Theming section in README.md](../../README.md#theming).
+- **Theming:** Customize the look and feel of the CLI to your preference. See [Themes section](./themes.md).
 - **Configuration:** Tailor the CLI's behavior through configuration files. See [CLI Configuration](./configuration.md).
 - **Special Commands:** Utilize built-in commands for tasks like managing history, memory, or display. See [Commands](./commands.md).
 - **Enhanced Input:** Support for multiline input editing and readline-like keybindings for a more comfortable and efficient command entry experience.
@@ -33,5 +33,6 @@ The Gemini CLI (`packages/cli`) is the primary way users interact with the Gemin
 
 - **[Commands](./commands.md):** A detailed reference for all built-in CLI commands (e.g., `/help`, `/history`, `/theme`).
 - **[Configuration](./configuration.md):** Understand how to configure various aspects of the CLI.
+- **[Themes](./themes.md)**: A guide to customizing the CLI's appearance with different themes.
 
 This documentation will help you become proficient in using the Gemini CLI for a wide range of tasks.

docs/cli/themes.md

@@ -0,0 +1,55 @@
+# Themes
+
+The Gemini CLI supports a variety of themes to customize its appearance. You can change the theme to suit your preferences via the `/theme` command. Below are the available themes:
+
+## Dark Themes
+
+### ANSI
+
+<img src="../assets/theme-ansi.png" alt="ANSI theme" width="600" />
+
+### Atom OneDark
+
+<img src="../assets/theme-atom-one.png" alt="Atom One theme" width="600">
+
+### Ayu
+
+<img src="../assets/theme-ayu.png" alt="Ayu theme" width="600">
+
+### Default
+
+<img src="../assets/theme-default.png" alt="Default theme" width="600">
+
+### Dracula
+
+<img src="../assets/theme-dracula.png" alt="Dracula theme" width="600">
+
+### GitHub
+
+<img src="../assets/theme-github.png" alt="GitHub theme" width="600">
+
+## Light Themes
+
+### ANSI Light
+
+<img src="../assets/theme-ansi-light.png" alt="ANSI Light theme" width="600">
+
+### Ayu Light
+
+<img src="../assets/theme-ayu-light.png" alt="Ayu Light theme" width="600">
+
+### Default Light
+
+<img src="../assets/theme-default-light.png" alt="Default Light theme" width="600">
+
+### GitHub Light
+
+<img src="../assets/theme-github-light.png" alt="GitHub Light theme" width="600">
+
+### Google Code
+
+<img src="../assets/theme-google-light.png" alt="Google Code theme" width="600">
+
+### Xcode
+
+<img src="../assets/theme-xcode-light.png" alt="Xcode Light theme" width="600">