@devries-cameron20 / t3code Mirror · read-only
Fork 0

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

main
md 149 lines 6.92 KB
Rendered Raw
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.