Skip to content

an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions

fix(ui): make title-bar tooltips actually appear

Chaitanya Giri47a514f68304
diff --git a/src/renderer/src/App.tsx b/src/renderer/src/App.tsx
index 5576b515..fd70ba27 100644
--- a/src/renderer/src/App.tsx
+++ b/src/renderer/src/App.tsx
@@ -287,7 +287,7 @@ export function App() {
terminal header — and the theme darkens the whole app, terminals
included (design/theme.ts + tokens.css dark block). */}
<button
- className="cth-titlebar-nodrag"
+ className="cth-titlebar-nodrag cth-tip"
onClick={() => {
const next = toggleAppTheme();
// Mirror into the harness config: every agent (re)spawned from now
@@ -296,7 +296,7 @@ export function App() {
// harness agents — the user's global Claude theme is never touched.
void window.cth.updateConfig({ terminalTheme: next });
}}
- title={appThemeNow === 'dark' ? 'Switch to the light theme' : 'Switch to the dark theme'}
+ data-tip={appThemeNow === 'dark' ? 'Light theme' : 'Dark theme'}
aria-label="Toggle dark mode"
style={{
marginLeft: 'auto',
@@ -313,9 +313,9 @@ export function App() {
{/* v0.3.4: the IDE button moved to agent level — every agent's header
(sidebar detail, god Command Center, fullscreen) carries it. */}
<button
- className="cth-titlebar-nodrag cth-settings-btn"
+ className="cth-titlebar-nodrag cth-settings-btn cth-tip"
onClick={() => { setSettingsSection(undefined); setSettingsOpen(true); }}
- title="Settings"
+ data-tip="Settings"
aria-label="Settings"
style={{
display: 'inline-flex', alignItems: 'center', justifyContent: 'center',
@@ -333,7 +333,7 @@ export function App() {
is drawn in — at 16-18px a pixel-grid glyph reads as a rendering
artifact next to the OS window controls, not as a style choice. */}
<button
- className="cth-titlebar-nodrag"
+ className="cth-titlebar-nodrag cth-tip"
onClick={() => {
if (fullscreenAgentId) { useStore.getState().setFullscreen(null); return; }
const all = useStore.getState().agents;
@@ -342,7 +342,7 @@ export function App() {
?? all.find((x) => x.ptyId);
if (target) useStore.getState().setFullscreen(target.id);
}}
- title={fullscreenAgentId ? 'Exit focus mode (Esc)' : 'Focus mode for the selected agent'}
+ data-tip={fullscreenAgentId ? 'Exit focus mode (Esc)' : 'Focus mode'}
aria-label="Toggle focus mode"
style={{
display: 'inline-flex', alignItems: 'center', justifyContent: 'center',
diff --git a/src/renderer/src/design/global.css b/src/renderer/src/design/global.css
index 63e52d60..e83275df 100644
--- a/src/renderer/src/design/global.css
+++ b/src/renderer/src/design/global.css
@@ -97,6 +97,37 @@ canvas, img, svg { image-rendering: pixelated; image-rendering: crisp-edges; }
.cth-titlebar-drag { -webkit-app-region: drag; }
.cth-titlebar-nodrag { -webkit-app-region: no-drag; }
+/* In-app tooltip for title-bar controls.
+ The native `title` attribute does not reliably render on buttons inside the
+ hiddenInset title bar, so those labels were correct in the markup and simply
+ invisible in the running app. CSS-only on purpose: no state, no re-render, and
+ nothing for the drag region to swallow. Usage: className="cth-tip"
+ data-tip="…". Keep aria-label for screen readers; drop `title` so a native
+ tooltip can never double up on this one. */
+.cth-tip { position: relative; }
+.cth-tip::after {
+ content: attr(data-tip);
+ position: absolute;
+ top: calc(100% + 6px);
+ right: 0;
+ white-space: nowrap;
+ padding: 3px 7px 2px;
+ font-family: var(--cth-font-ui);
+ font-size: 11px;
+ line-height: 16px;
+ color: var(--cth-cream-100);
+ background: var(--cth-ink-900);
+ box-shadow: inset 0 0 0 1px var(--cth-ink-700);
+ opacity: 0;
+ pointer-events: none;
+ /* Delay matches the native tooltip feel, so it does not flash while the
+ pointer is just crossing the title bar on its way somewhere else. */
+ transition: opacity 90ms ease-out 400ms;
+ z-index: 100;
+}
+.cth-tip:hover::after,
+.cth-tip:focus-visible::after { opacity: 1; }
+
/* Settings (gear) button in the title bar — a clear bordered chip with a
neo-brutalist hover (lemon fill + offset shadow) so it reads as a button. */
.cth-settings-btn { transition: background 80ms steps(2), box-shadow 80ms steps(2), transform 80ms steps(2); }