The best way to control Claude Code, Codex and more from any computer or phone
Mirrored from https://github.com/Camo67/t3code.git
Synced Nov 21, 03:37 UTC
| 1 | # Appearance and themes |
| 2 | |
| 3 | On web and desktop, open **Settings → Appearance** to choose a theme and follow the system |
| 4 | appearance or stay in light or dark mode. To use different themes for light and dark mode, select |
| 5 | the corresponding preview within each theme. Appearance preferences are saved separately on each |
| 6 | device or browser. |
| 7 | |
| 8 | On web and desktop, use **Change theme** in the command palette to select a theme without leaving chat. |
| 9 | Press **Cmd+Option+A** on macOS or **Ctrl+Alt+A** on Windows/Linux to open the theme picker directly. |
| 10 | Use **Change appearance** in the command palette to choose System, Light, or Dark independently of |
| 11 | the theme. **Cmd+Option+Shift+A** on macOS or **Ctrl+Alt+Shift+A** on Windows/Linux cycles through |
| 12 | those modes. Customize these shortcuts under **Settings → Keybindings**. |
| 13 | |
| 14 | On mobile, open **Settings → Appearance**. Mobile has its own themes and text, |
| 15 | code, and terminal preferences. It does not follow environment themes or defaults. |
| 16 | |
| 17 | On Android 12 or newer, choose the **Material You** theme in Appearance to use colors from |
| 18 | your wallpaper. Selecting another theme replaces those colors. Like other themes, Material You |
| 19 | can be selected separately for light and dark appearances. |
| 20 | Android uses **Material You Layout** by default unless you have turned it off in Appearance. |
| 21 | It changes shapes, spacing, and controls independently |
| 22 | of the selected theme. |
| 23 | |
| 24 | ## Composer context |
| 25 | |
| 26 | Git-backed projects show branch and worktree controls below the composer while you create a thread. |
| 27 | The controls retreat as the composer docks after you send the first message. |
| 28 | |
| 29 | Turn on **Composer context** to keep those controls visible after the thread starts. This preference |
| 30 | applies to the web and desktop clients. |
| 31 | |
| 32 | ## Math |
| 33 | |
| 34 | Turn on **Render math** in **Settings → Appearance** to typeset LaTeX in messages and Markdown |
| 35 | previews on web, desktop, and mobile. It reads `$…$`, `$$…$$`, `\(…\)`, and `\[…\]`, outside of code. |
| 36 | Fenced `math` blocks also render. Formulas work in tables, including absolute-value bars. |
| 37 | Dollar amounts such as `$5 and $10` stay text; write `\$` to keep any other dollar sign literal. |
| 38 | Wide formulas scroll horizontally while the surrounding text wraps. Copying a formula or |
| 39 | exporting a table preserves the TeX. |
| 40 | |
| 41 | The composer keeps TeX source editable, including when rich text is enabled. The Render math |
| 42 | preference is saved separately on each device. |
| 43 | |
| 44 | ## Motion |
| 45 | |
| 46 | The main sidebar, right panel, and terminal drawer open and close immediately by default. Move the |
| 47 | **Panel animations** slider above 0 ms to add motion, up to 400 ms, unless reduced motion is enabled |
| 48 | in your operating system. Moving between threads always snaps to the selected thread's panel state |
| 49 | without replaying its transitions. |
| 50 | |
| 51 | ## Custom themes |
| 52 | |
| 53 | On web and desktop, choose **Create theme** to adjust a palette, or import a T3 Code or VS Code |
| 54 | theme. The theme editor's color picker lets you select an area of the app to find the color to |
| 55 | change. Export your theme as JSON to share it. |
| 56 | |
| 57 | ### Custom CSS |
| 58 | |
| 59 | For a change that colors cannot make, open **Custom CSS** in the theme editor. The CSS is saved with |
| 60 | the theme, applies after T3 Code's own styles on web and desktop, and is included in exports. Use |
| 61 | `.dark` or `:root:not(.dark)` to target one appearance. |
| 62 | |
| 63 | Custom CSS cannot load files. `@import`, `image-set()`, and `url()` are ignored, except `url()` |
| 64 | with a `data:` address or an `#id`. This keeps an imported theme from sending what is on your screen |
| 65 | to another site. For a full-size image, use a [background image](#background-image). |
| 66 | |
| 67 | Class names in the app change between releases. For rules that keep working, target `data-slot` |
| 68 | and other `data-` attributes, such as `[data-chat-header]` or `[data-slot="button"]`. |
| 69 | |
| 70 | If a rule hides something you need, run `t3 theme set t3-chat` on the server to switch to a |
| 71 | built-in theme, or press **Cmd+Option+A** on macOS or **Ctrl+Alt+A** on Windows/Linux to pick |
| 72 | another theme. |
| 73 | |
| 74 | ### Ask an agent |
| 75 | |
| 76 | An agent on the same machine as the server can restyle T3 Code for you. Ask it to change the look, |
| 77 | for example "make T3 Code's chat header taller" or "give T3 Code a solarized theme". It publishes |
| 78 | an [environment theme](#environment-themes) with colors and CSS, and web and desktop clients of that |
| 79 | server switch to it. It can also switch them to light, dark, or system mode. The thread must run |
| 80 | in Full access. Ask the agent to set a built-in theme to undo it. |
| 81 | |
| 82 | ## Environment themes |
| 83 | |
| 84 | Environment themes and defaults come from the server serving your web app or the desktop app's |
| 85 | main local environment. With the desktop app's local environment off, they come from the |
| 86 | [background service](./background-service.md) on the same machine while the app is connected to |
| 87 | it. app.t3.codes and other connections do not use them. |
| 88 | |
| 89 | Select a published theme in **Settings → Appearance** to follow its palette as the server updates |
| 90 | it. **Duplicate** makes an independent copy you can edit. A saved custom theme with the same ID |
| 91 | takes precedence. If the server stops publishing the selected theme, T3 Code falls back to its |
| 92 | standard theme. |
| 93 | |
| 94 | Run this on the server to set a default and switch connected clients to it: |
| 95 | |
| 96 | ```bash |
| 97 | t3 theme set nightfall |
| 98 | ``` |
| 99 | |
| 100 | Clients that are offline apply it when they reconnect. Each client applies the setting once; |
| 101 | choosing another theme afterward sticks until the next `t3 theme set`. Run the command again to |
| 102 | reapply it, even if the name is unchanged. |
| 103 | |
| 104 | `t3 theme clear` removes the default without changing anyone's current theme. `t3 theme show` lists |
| 105 | the default and published themes. |
| 106 | |
| 107 | ### Publish a theme |
| 108 | |
| 109 | Save a theme exported from T3 Code into `~/.t3/userdata/themes/` on the server, or the `themes` |
| 110 | directory under your custom state directory. The filename supplies the theme ID: `nightfall.json` |
| 111 | can be selected with `t3 theme set nightfall`. Keep the filename stable when updating its colors. |
| 112 | Do not use `system`, `light`, `dark`, or a built-in theme's ID. |
| 113 | |
| 114 | For an integration that generates a palette, this shorter format also works: |
| 115 | |
| 116 | ```json |
| 117 | { |
| 118 | "name": "Nightfall", |
| 119 | "appearance": "dark", |
| 120 | "canvas": "#1a1b26", |
| 121 | "accent": "#7aa2f7", |
| 122 | "colors": { |
| 123 | "terminalSelection": "#292e42", |
| 124 | "error": "#f7768e" |
| 125 | } |
| 126 | } |
| 127 | ``` |
| 128 | |
| 129 | Set `appearance` to `light` or `dark` and supply hex colors for `canvas` and `accent`. T3 Code |
| 130 | generates the rest. The optional `colors` overrides use the names in the theme editor's advanced |
| 131 | view. An optional `css` string adds [custom CSS](#custom-css). |
| 132 | |
| 133 | Write updates to a temporary file and rename it into place so clients never read a partial theme. |
| 134 | Invalid files are not published. |
| 135 | |
| 136 | ### Background image |
| 137 | |
| 138 | A published theme can have a full-size background image. Ask an agent, for example "use |
| 139 | ~/Pictures/wallpaper.jpg as T3 Code's background", or save a JPEG, PNG, or WebP file of up to |
| 140 | 16 MB beside the theme file: `nightfall.jpg` beside `nightfall.json`. The theme's CSS decides |
| 141 | where the image shows: |
| 142 | |
| 143 | ```css |
| 144 | [data-workspace-area="conversation"] { |
| 145 | background: var(--theme-background-image) center / cover no-repeat; |
| 146 | } |
| 147 | ``` |
| 148 | |
| 149 | Delete the image file to remove it. |