Skip to content

Commit 0d84ea1

Browse files
dorlugasigalCopilot
andcommitted
fix(hub): ground every empty-state tip in real shipping behavior
Five parallel verification sub-agents cross-checked every tip against the actual code paths it described. Findings: • Three tips claimed features that don't exist as described and have been dropped or rewritten: - 'Files in agent output? Tap them' — file paths in agent text are NOT made tappable; only tool-call results show diffs. Replaced with 'Watch the agent edit your code' which describes the real DiffViewer behavior on tool-call edits. - 'Paste long text safely' previously promised a confirm overlay (PasteOverlay component is unused). Rewritten to describe the real protection: bracketed-paste markers wrap multi-line input. - 'Auto theme on iOS / Android' claimed a System theme that does not exist; dropped (themes are listed individually). • Nine tips had inaccurate wording that has been tightened: - Stack more keys: handle is tapped, not dragged. - Feel every keypress: setting lives in 'Notifications & Feedback'. - Split the screen: actions are 'Split vertical' / 'Split horizontal'. - Tabs inside a session → Sessions live in tabs (New tab opens another top-level session, not a shell within one). - Clear without typing: clear() wipes scrollback too. - About: shows version + doc/source links + update check; it does NOT show the tunnel URL. - Save a workspace: action lives in Settings → Workspaces, not in the Tools panel. - Pick up where you left off: supported agents are Copilot, Claude, OpenCode (not 'Codex'); Resume Agent opens a fresh terminal with history, not an attach to a running process. - Multiple shells, one tap: action label is 'New tab', not 'New Session'. - Cellular access: tunnels are ephemeral by default — call out that --persisted-tunnel buys you stability. - Get pinged: trigger is bell signals + silence after activity, not 'long-running command finishes'. Net: 41 → 40 tips, every one of them now traceable to the code path it describes. Test minimum bumped to 35 last commit so still passes. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 992619a commit 0d84ea1

1 file changed

Lines changed: 19 additions & 24 deletions

File tree

  • src/frontend/src/components/SessionsHub

src/frontend/src/components/SessionsHub/tips.ts

Lines changed: 19 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ export const HUB_TIPS: Tip[] = [
4242
{
4343
icon: '↕️',
4444
title: 'Stack more keys',
45-
body: 'Drag the TouchBar handle upward to add up to 3 rows for vim, tmux, or your own combos',
45+
body: 'Tap the TouchBar handle to expand and reveal up to 3 rows for vim, tmux, or your own combos',
4646
},
4747
{
4848
icon: '⚙️',
@@ -62,12 +62,12 @@ export const HUB_TIPS: Tip[] = [
6262
{
6363
icon: '🗂️',
6464
title: 'Save a workspace',
65-
body: 'Group your favorite sessions into a workspace from ▦ → Save Workspace, then re-launch with one tap',
65+
body: 'Group your favorite sessions in Settings → Workspaces → Save current as new workspace, then re-launch with one tap',
6666
},
6767
{
6868
icon: '↺',
6969
title: 'Pick up where you left off',
70-
body: 'Resume Agent reattaches to running Claude Code, Codex, or other agent sessions with full history',
70+
body: 'Resume Agent opens your latest Copilot, Claude, or OpenCode conversation in a fresh terminal with the full history',
7171
},
7272
{
7373
icon: '⏯',
@@ -77,7 +77,7 @@ export const HUB_TIPS: Tip[] = [
7777
{
7878
icon: '🛰️',
7979
title: 'Cellular access on the go',
80-
body: 'A persistent dev tunnel lets you reach this terminal from your phone over LTE — no VPN needed',
80+
body: 'An optional dev tunnel lets you reach this terminal from your phone over LTE — no VPN, no LAN, no fuss',
8181
},
8282
{
8383
icon: '🎨',
@@ -106,13 +106,13 @@ export const HUB_TIPS: Tip[] = [
106106
},
107107
{
108108
icon: '🔔',
109-
title: 'Get pinged when builds finish',
110-
body: 'Enable Notifications in Settings — TermBeam beeps and buzzes when a long-running command completes',
109+
title: 'Get pinged when output goes quiet',
110+
body: 'Enable Notifications in Settings — TermBeam beeps on bell signals or after a busy command goes silent',
111111
},
112112
{
113113
icon: '📳',
114114
title: 'Feel every keypress',
115-
body: 'Haptics on iOS-style devices add a subtle buzz to TouchBar taps — toggle in Settings → Notifications',
115+
body: 'Haptics on iOS-style devices add a subtle buzz to TouchBar taps — toggle in Settings → Notifications & Feedback',
116116
},
117117
{
118118
icon: '🧭',
@@ -137,12 +137,12 @@ export const HUB_TIPS: Tip[] = [
137137
{
138138
icon: '🪄',
139139
title: 'Multiple shells, one tap',
140-
body: 'Open ▦ → New Session and pick zsh, bash, pwsh — TermBeam picks up your installed shells automatically',
140+
body: 'Open ▦ → New tab and pick zsh, bash, pwsh — TermBeam auto-detects every shell installed on your machine',
141141
},
142142
{
143-
icon: '🧩',
144-
title: 'Files in agent output? Tap them',
145-
body: 'When Claude Code or Codex mentions a file path, tap it to open the in-app code viewer — diffs included',
143+
icon: '📑',
144+
title: 'Watch the agent edit your code',
145+
body: 'When Claude or Copilot edits a file through a tool call, the change renders as a diff right inside the chat',
146146
},
147147
{
148148
icon: '🔭',
@@ -152,7 +152,7 @@ export const HUB_TIPS: Tip[] = [
152152
{
153153
icon: '🪟',
154154
title: 'Split the screen',
155-
body: 'Tap ▦ → Split to put two terminals side by side — perfect for tests in one and edits in the other',
155+
body: 'Open ▦ → Split vertical or Split horizontal to put two terminals side by side — tests in one, edits in the other',
156156
},
157157
{
158158
icon: '🏷️',
@@ -186,13 +186,13 @@ export const HUB_TIPS: Tip[] = [
186186
},
187187
{
188188
icon: '🗒️',
189-
title: 'Tabs inside a session',
190-
body: 'Tap ▦ → New tab to open another shell inside the same session — switch between them from the tab bar',
189+
title: 'Sessions live in tabs',
190+
body: 'Tap ▦ → New tab to spin up another session — switch between every running session from the tab bar at the top',
191191
},
192192
{
193193
icon: '🧹',
194-
title: 'Clear without typing',
195-
body: 'Hit ▦ → Clear terminal when scrollback gets noisy — quicker than reaching for the C key on the on-screen keyboard',
194+
title: 'Clean slate, no typing',
195+
body: 'Hit ▦ → Clear terminal to wipe both the viewport and scrollback — quicker than reaching for the on-screen keyboard',
196196
},
197197
{
198198
icon: '🧯',
@@ -201,8 +201,8 @@ export const HUB_TIPS: Tip[] = [
201201
},
202202
{
203203
icon: '📎',
204-
title: 'Paste long text safely',
205-
body: 'When you paste multi-line content, TermBeam shows a confirm overlay so a stray newline can never run a command by surprise',
204+
title: 'Paste many lines, no surprises',
205+
body: 'Multi-line pastes use bracketed-paste markers so the shell treats them as one chunk — no stray commands sneak through',
206206
},
207207
{
208208
icon: '🔐',
@@ -214,11 +214,6 @@ export const HUB_TIPS: Tip[] = [
214214
title: 'Watch a teammate live',
215215
body: 'Multiple browsers attached to the same session see the same output frame-by-frame — great for pair debugging',
216216
},
217-
{
218-
icon: '🌗',
219-
title: 'Auto theme on iOS / Android',
220-
body: 'Pick the System theme and TermBeam follows your phone\u2019s light/dark schedule automatically',
221-
},
222217
{
223218
icon: '🖋️',
224219
title: 'Tweak the font, not the world',
@@ -227,7 +222,7 @@ export const HUB_TIPS: Tip[] = [
227222
{
228223
icon: 'ℹ️',
229224
title: 'Wondering what version you are on?',
230-
body: 'Tap ▦ → About to see the running version, your tunnel URL, and quick links to docs',
225+
body: 'Tap ▦ → About to see the running version, links to docs and source, and a one-tap update check',
231226
},
232227
];
233228

0 commit comments

Comments
 (0)