Skip to content

Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.

fix(desktop): open section submenus on hover

leepokai6efd61efd785
diff --git a/apps/desktop/src/renderer/lib/menu-placement.test.ts b/apps/desktop/src/renderer/lib/menu-placement.test.ts
new file mode 100644
index 00000000..5d6b6833
--- /dev/null
+++ b/apps/desktop/src/renderer/lib/menu-placement.test.ts
@@ -0,0 +1,25 @@
+import assert from 'node:assert/strict'
+import { test } from 'node:test'
+import { menuPlacement, submenuPlacement } from './menu-placement.ts'
+
+const size = { width: 260, height: 120 }
+const parent = { left: 30, top: 80, right: 290, width: 260, height: 240 }
+
+test('hovered submenu opens beside the parent aligned with its row', () => {
+ assert.deepEqual(submenuPlacement(parent, { top: 120 }, size, { width: 1000, height: 700 }),
+ { left: 294, top: 113, width: 260 })
+})
+
+test('submenu flips left at the right edge and stays above the bottom edge', () => {
+ assert.deepEqual(submenuPlacement({ ...parent, left: 700, right: 960 }, { top: 650 }, size, { width: 1000, height: 700 }),
+ { left: 436, top: 572, width: 260 })
+})
+
+test('small windows keep both menus inside the viewport', () => {
+ const view = { width: 240, height: 200 }
+ const placed = menuPlacement({ x: 220, y: 190 }, size, view)
+ assert.deepEqual(placed, { left: 8, top: 72, width: 224 })
+ const sub = submenuPlacement({ ...parent, ...placed, right: placed.left + placed.width }, { top: 100 }, size, view)
+ assert.equal(sub.left, 8)
+ assert.equal(sub.width, 224)
+})
diff --git a/apps/desktop/src/renderer/lib/menu-placement.ts b/apps/desktop/src/renderer/lib/menu-placement.ts
new file mode 100644
index 00000000..24f45f85
--- /dev/null
+++ b/apps/desktop/src/renderer/lib/menu-placement.ts
@@ -0,0 +1,26 @@
+/** Floating menu geometry, in window coordinates. */
+interface Size { width: number; height: number }
+interface Rect extends Size { left: number; top: number; right: number }
+const INSET = 8
+const GAP = 4
+export const ACTION_MENU_WIDTH = 260
+
+export function menuPlacement(point: { x: number; y: number }, size: Size, view: Size) {
+ const width = Math.min(size.width, Math.max(0, view.width - INSET * 2))
+ return {
+ width,
+ left: clamp(point.x, view.width - width - INSET),
+ top: clamp(point.y, view.height - size.height - INSET),
+ }
+}
+
+/** Prefer beside the parent, flip left when needed, and align with the hovered row. */
+export function submenuPlacement(parent: Rect, row: { top: number }, size: Size, view: Size) {
+ const right = parent.right + GAP
+ const left = right + size.width <= view.width - INSET ? right : parent.left - GAP - size.width
+ return menuPlacement({ x: left, y: row.top - 7 }, size, view)
+}
+
+function clamp(value: number, maximum: number) {
+ return Math.max(INSET, Math.min(value, maximum))
+}
diff --git a/apps/desktop/src/renderer/lib/submenu-hover.test.ts b/apps/desktop/src/renderer/lib/submenu-hover.test.ts
new file mode 100644
index 00000000..cc81b9b4
--- /dev/null
+++ b/apps/desktop/src/renderer/lib/submenu-hover.test.ts
@@ -0,0 +1,45 @@
+import assert from 'node:assert/strict'
+import { test } from 'node:test'
+import { submenuHover, SUBMENU_HOVER_MS } from './submenu-hover.ts'
+
+test('resting over a submenu row opens it without clicking', (t) => {
+ t.mock.timers.enable({ apis: ['setTimeout'] })
+ const opened: (number | null)[] = []
+ const hover = submenuHover((index) => opened.push(index))
+ hover.schedule(1)
+ t.mock.timers.tick(SUBMENU_HOVER_MS - 1)
+ assert.deepEqual(opened, [])
+ hover.schedule(1) // Moving inside the same row does not postpone opening.
+ t.mock.timers.tick(1)
+ assert.deepEqual(opened, [1])
+})
+
+test('crossing into the child cancels closing across the gap', (t) => {
+ t.mock.timers.enable({ apis: ['setTimeout'] })
+ const opened: (number | null)[] = []
+ const hover = submenuHover((index) => opened.push(index))
+ hover.schedule(1)
+ t.mock.timers.tick(SUBMENU_HOVER_MS)
+ hover.schedule(null)
+ t.mock.timers.tick(50)
+ hover.cancel()
+ t.mock.timers.tick(SUBMENU_HOVER_MS)
+ assert.deepEqual(opened, [1])
+ hover.schedule(null)
+ t.mock.timers.tick(SUBMENU_HOVER_MS)
+ assert.deepEqual(opened, [1, null])
+})
+
+test('passing another row or dismissing the menu cancels a pending open', (t) => {
+ t.mock.timers.enable({ apis: ['setTimeout'] })
+ const opened: (number | null)[] = []
+ const hover = submenuHover((index) => opened.push(index))
+ hover.schedule(1)
+ hover.schedule(2)
+ t.mock.timers.tick(SUBMENU_HOVER_MS)
+ assert.deepEqual(opened, [2])
+ hover.schedule(3)
+ hover.cancel()
+ t.mock.timers.tick(SUBMENU_HOVER_MS)
+ assert.deepEqual(opened, [2])
+})
diff --git a/apps/desktop/src/renderer/lib/submenu-hover.ts b/apps/desktop/src/renderer/lib/submenu-hover.ts
new file mode 100644
index 00000000..e4338d44
--- /dev/null
+++ b/apps/desktop/src/renderer/lib/submenu-hover.ts
@@ -0,0 +1,25 @@
+/** A short pause prevents passing over a row from changing the menu, and bridges the gap to its child. */
+export const SUBMENU_HOVER_MS = 150
+
+export function submenuHover(change: (index: number | null) => void) {
+ let pending: ReturnType<typeof setTimeout> | undefined
+ let target: number | null | undefined
+ const cancel = () => {
+ clearTimeout(pending)
+ pending = undefined
+ target = undefined
+ }
+ return {
+ cancel,
+ schedule(index: number | null) {
+ if (pending && target === index) return
+ cancel()
+ target = index
+ pending = setTimeout(() => {
+ pending = undefined
+ target = undefined
+ change(index)
+ }, SUBMENU_HOVER_MS)
+ },
+ }
+}
diff --git a/apps/desktop/src/renderer/views/ChatWindow.tsx b/apps/desktop/src/renderer/views/ChatWindow.tsx
index 680e2d24..49aaa640 100644
--- a/apps/desktop/src/renderer/views/ChatWindow.tsx
+++ b/apps/desktop/src/renderer/views/ChatWindow.tsx
@@ -37,7 +37,8 @@ export { EmptyState } from './HostStateView'
import { RefreshIndicator } from './RefreshIndicator'
import { StarPrompt } from './StarPrompt'
import { OpenVoiceSettings } from './call/CallView'
-import { AccountPanelLayer, DesktopActionMenu, ProfileAvatar, type ActionItem } from './PanelMenus'
+import { AccountPanelLayer, ProfileAvatar } from './PanelMenus'
+import { DesktopActionMenu, type ActionItem } from './DesktopActionMenu'
import { moveToSectionItems, sectionHeaderItems, type SectionNaming } from './section-menus'
import { makeLeadItems, offersDelete, voiceTarget } from './lead-menus'
import { SectionNameDialog } from './SectionNameDialog'
diff --git a/apps/desktop/src/renderer/views/DesktopActionMenu.tsx b/apps/desktop/src/renderer/views/DesktopActionMenu.tsx
new file mode 100644
index 00000000..f6ccbe48
--- /dev/null
+++ b/apps/desktop/src/renderer/views/DesktopActionMenu.tsx
@@ -0,0 +1,85 @@
+import { useEffect, useLayoutEffect, useRef, useState } from 'react'
+import type { MenuItem } from '../components/Overlay'
+import { ACTION_MENU_WIDTH, menuPlacement, submenuPlacement } from '../lib/menu-placement'
+import { submenuHover } from '../lib/submenu-hover'
+import { useTr } from '../lib/use-language'
+import { PanelRows, type PanelItem } from './PanelMenus'
+
+/** Roster actions, with one level of desktop submenus. */
+export type ActionItem = MenuItem | (Omit<MenuItem, 'action'> & { submenu: MenuItem[] })
+
+/** Hover opens a child beside its parent. Clicking, Enter, and → enter it; ← or Escape returns. */
+export function DesktopActionMenu({ items, onDismiss, x, y }: { items: ActionItem[]; onDismiss: () => void; x: number; y: number }) {
+ const tr = useTr()
+ const menu = useRef<HTMLDivElement>(null)
+ const child = useRef<HTMLDivElement>(null)
+ const anchor = useRef<HTMLButtonElement | null>(null)
+ const hoveredRow = useRef<HTMLButtonElement | null>(null)
+ const [open, setOpen] = useState<number | null>(null)
+ const [level, setLevel] = useState<'parent' | 'child'>('parent')
+ const [view, setView] = useState({ width: window.innerWidth, height: window.innerHeight })
+ const [size, setSize] = useState({ parent: 0, child: 0 })
+ const hover = useRef<ReturnType<typeof submenuHover> | null>(null)
+ if (!hover.current) hover.current = submenuHover((index) => {
+ if (index !== null) anchor.current = hoveredRow.current
+ setOpen(index)
+ })
+ useEffect(() => () => hover.current?.cancel(), [])
+ useEffect(() => {
+ const resize = () => { hover.current?.cancel(); setOpen(null); setLevel('parent'); setView({ width: window.innerWidth, height: window.innerHeight }) }
+ window.addEventListener('resize', resize)
+ return () => window.removeEventListener('resize', resize)
+ }, [])
+ useLayoutEffect(() => {
+ const parent = menu.current?.offsetHeight ?? 0
+ const sub = child.current?.offsetHeight ?? 0
+ setSize((old) => old.parent === parent && old.child === sub ? old : { parent, child: sub })
+ })
+ const closeChild = () => { hover.current?.cancel(); setOpen(null); setLevel('parent') }
+ const returnToParent = () => { closeChild(); anchor.current?.focus({ preventScroll: true }) }
+ const enter = (index: number, row: HTMLButtonElement | null) => {
+ const item = items[index]
+ if (!row || !item || !('submenu' in item)) return
+ hover.current?.cancel()
+ anchor.current = row
+ setOpen(index)
+ setLevel('child')
+ }
+ const point = (index: number, row: HTMLButtonElement) => {
+ const item = items[index]
+ setLevel('parent')
+ if (item && 'submenu' in item) {
+ hoveredRow.current = row
+ hover.current?.schedule(index)
+ } else hover.current?.schedule(null)
+ }
+ const convert = (item: ActionItem, index: number): PanelItem => ({
+ title: item.title, icon: item.icon ?? 'circle', detail: item.detail, verbatim: item.verbatim, destructive: item.destructive,
+ ...('submenu' in item ? { chevron: true, submenu: true, expanded: open === index, action: (row: HTMLButtonElement | null) => enter(index, row) }
+ : { action: () => { onDismiss(); item.action() } }),
+ })
+ const branch = open === null ? null : items[open]
+ const sub = branch && 'submenu' in branch ? branch : null
+ const placement = menuPlacement({ x, y }, { width: ACTION_MENU_WIDTH, height: size.parent }, view)
+ const subPlacement = sub && anchor.current && menu.current ? submenuPlacement(
+ { ...placement, right: placement.left + placement.width, height: size.parent }, anchor.current.getBoundingClientRect(),
+ { width: ACTION_MENU_WIDTH, height: size.child }, view,
+ ) : null
+ return <div onMouseLeave={() => hover.current?.schedule(null)} onMouseEnter={() => hover.current?.cancel()}>
+ <div ref={menu} className="action-menu" style={placement}>
+ <div className="action-menu-rows" onScroll={closeChild}>
+ <PanelRows items={items.map(convert)} active={level === 'parent' || !sub} onDismiss={onDismiss}
+ onPoint={point} onNavigate={closeChild} onForward={enter}
+ after={(i) => items[i + 1]?.divider ? <div className="panel-divider" role="separator" /> : null} />
+ </div>
+ </div>
+ {sub && subPlacement ? <div ref={child} className="action-submenu" style={subPlacement}
+ onMouseEnter={() => { hover.current?.cancel(); setLevel('child') }}>
+ <div className="action-menu-rows">
+ <PanelRows key={open} label={sub.verbatim ? sub.title : tr(sub.title)} items={sub.submenu.map(convert)}
+ active={level === 'child'} onDismiss={returnToParent} onBack={returnToParent}
+ after={(i) => sub.submenu[i + 1]?.divider ? <div className="panel-divider" role="separator" /> : null} />
+ </div>
+ </div> : null}
+ </div>
+}
diff --git a/apps/desktop/src/renderer/views/PanelMenus.tsx b/apps/desktop/src/renderer/views/PanelMenus.tsx
index 974753c7..964a1899 100644
--- a/apps/desktop/src/renderer/views/PanelMenus.tsx
+++ b/apps/desktop/src/renderer/views/PanelMenus.tsx
@@ -1,7 +1,6 @@
-import { useEffect, useLayoutEffect, useRef, useState, type ReactNode } from 'react'
+import { useEffect, useRef, useState, type ReactNode } from 'react'
import { Spinner } from '../components/Controls'
import { Icon } from '../components/Icon'
-import type { MenuItem } from '../components/Overlay'
import { IconSlot, VStack } from '../components/Stack'
import { Text } from '../components/Text'
import type { Link } from '@shared/analytics'
@@ -27,7 +26,7 @@ export function ProfileAvatar() {
)
}
-interface PanelItem {
+export interface PanelItem {
title: string
icon: string
detail?: string | null
@@ -38,7 +37,9 @@ interface PanelItem {
destructive?: boolean
/** A name the user gave: shown as typed, never translated. */
verbatim?: boolean
- action: () => void
+ action: (anchor: HTMLButtonElement | null) => void
+ submenu?: boolean
+ expanded?: boolean
}
/** The account menu: a window-local floating surface (no system menu styling). */
@@ -107,46 +108,80 @@ export function AccountPanelLayer({ compact, approvals, onDismiss, onUsage, onSe
)
}
-function PanelRows({ items, onDismiss, after }: { items: PanelItem[]; onDismiss: () => void; after?: (i: number) => ReactNode }) {
+export function PanelRows({ items, onDismiss, after, active = true, label, onPoint, onNavigate, onForward, onBack }: {
+ items: PanelItem[]
+ onDismiss: () => void
+ after?: (i: number) => ReactNode
+ active?: boolean
+ label?: string
+ onPoint?: (index: number, row: HTMLButtonElement) => void
+ onNavigate?: () => void
+ onForward?: (index: number, row: HTMLButtonElement | null) => void
+ onBack?: () => void
+}) {
const tr = useTr()
const [highlighted, setHighlighted] = useState(0)
+ const pointed = useRef(-1)
const highlightedRow = useRef<HTMLButtonElement>(null)
// A long list scrolls: ↑/↓ and Tab bring the row Enter would run into view.
// A block, not an arrow's value: Chromium's scrollIntoView returns a promise, which React would call as the clean-up.
useEffect(() => {
+ if (!active) return
+ highlightedRow.current?.focus({ preventScroll: true })
highlightedRow.current?.scrollIntoView({ block: 'nearest' })
- }, [highlighted])
+ }, [highlighted, active])
useEffect(() => {
+ if (!active) return
const onKey = (e: KeyboardEvent) => {
+ if (!items.length && e.key !== 'Escape') return
if (e.key === 'Escape') {
e.preventDefault()
onDismiss()
} else if (e.key === 'ArrowDown' || (e.key === 'Tab' && !e.shiftKey)) {
e.preventDefault()
+ onNavigate?.()
+ pointed.current = -1
setHighlighted((h) => (h + 1) % items.length)
} else if (e.key === 'ArrowUp' || (e.key === 'Tab' && e.shiftKey)) {
e.preventDefault()
+ onNavigate?.()
+ pointed.current = -1
setHighlighted((h) => (h - 1 + items.length) % items.length)
+ } else if (e.key === 'ArrowRight' && onForward) {
+ e.preventDefault()
+ onForward(highlighted, highlightedRow.current)
+ } else if (e.key === 'ArrowLeft' && onBack) {
+ e.preventDefault()
+ onBack()
} else if (e.key === 'Enter' || e.key === ' ') {
e.preventDefault()
const item = items[highlighted]
- if (item && !item.disabled) item.action()
+ if (item && !item.disabled) item.action(highlightedRow.current)
}
}
window.addEventListener('keydown', onKey)
return () => window.removeEventListener('keydown', onKey)
- }, [items, highlighted, onDismiss])
+ }, [items, highlighted, onDismiss, active, onNavigate, onForward, onBack])
return (
- <VStack gap={2}>
+ <VStack gap={2} role="menu" aria-label={label} onMouseLeave={() => { pointed.current = -1 }}>
{items.map((item, i) => (
- <div key={item.title}>
+ <div key={`${i}-${item.title}`} role="none">
<button
ref={highlighted === i ? highlightedRow : undefined}
- className={`panel-row ${highlighted === i ? 'highlight' : ''} ${item.destructive ? 'destructive' : ''}`}
+ className={`panel-row ${item.expanded || (active && highlighted === i) ? 'highlight' : ''} ${item.destructive ? 'destructive' : ''}`}
+ role="menuitem"
+ tabIndex={active && highlighted === i ? 0 : -1}
+ aria-haspopup={item.submenu ? 'menu' : undefined}
+ aria-expanded={item.submenu ? item.expanded : undefined}
disabled={item.disabled}
// Movement, not enter: Chromium re-enters the row under a resting pointer after a scroll, which would undo ↑/↓.
- onMouseMove={() => setHighlighted(i)}
- onClick={item.action}
+ onMouseMove={(e) => {
+ setHighlighted(i)
+ if (pointed.current === i) return
+ pointed.current = i
+ onPoint?.(i, e.currentTarget)
+ }}
+ onClick={(e) => item.action(e.currentTarget)}
>
<IconSlot width={20}>
{item.image ? <img src={item.image} alt="" width={14} height={14} /> : <Icon name={item.icon} size={14} />}
@@ -161,33 +196,3 @@ function PanelRows({ items, onDismiss, after }: { items: PanelItem[]; onDismiss:
</VStack>
)
}
-
-/** A roster menu row: an action, or with `submenu`, rows that open in the menu's place (as the account menu opens Support). */
-export type ActionItem = MenuItem | (Omit<MenuItem, 'action'> & { submenu: MenuItem[] })
-
-/** The roster's right-click actions at `x`, `y`, shared by pointer and keyboard; kept inside the window, a long list scrolling. */
-export function DesktopActionMenu({ items, onDismiss, x, y }: { items: ActionItem[]; onDismiss: () => void; x: number; y: number }) {
- const [submenu, setSubmenu] = useState<{ title: string; items: MenuItem[] } | null>(null)
- const menu = useRef<HTMLDivElement>(null)
- // Measured after every render: a submenu, or a window resized under it, changes its height.
- const [height, setHeight] = useState(0)
- useLayoutEffect(() => setHeight(menu.current?.offsetHeight ?? 0))
- const row = (m: ActionItem): PanelItem => 'submenu' in m
- ? { title: m.title, icon: m.icon ?? 'circle', chevron: true, action: () => setSubmenu({ title: m.title, items: m.submenu }) }
- : { title: m.title, icon: m.icon ?? 'circle', destructive: m.destructive, verbatim: m.verbatim, action: () => { onDismiss(); m.action() } }
- const rows: { row: PanelItem; divider?: boolean }[] = submenu
- ? [{ row: { title: submenu.title, icon: 'chevron.left', action: () => setSubmenu(null) } }, ...submenu.items.map((m, i) => ({ row: row(m), divider: i === 0 || m.divider }))]
- : items.map((m) => ({ row: row(m), divider: m.divider }))
- return (
- <div ref={menu} className="action-menu" style={{ left: Math.min(Math.max(8, x), window.innerWidth - 268), top: Math.max(8, Math.min(y, window.innerHeight - 8 - height)) }}>
- <div className="action-menu-rows">
- <PanelRows
- key={submenu?.title}
- items={rows.map((r) => r.row)}
- onDismiss={onDismiss}
- after={(i) => (rows[i + 1]?.divider ? <div className="panel-divider" /> : null)}
- />
- </div>
- </div>
- )
-}
diff --git a/apps/desktop/src/renderer/views/chat-window.css b/apps/desktop/src/renderer/views/chat-window.css
index b506a399..498143fc 100644
--- a/apps/desktop/src/renderer/views/chat-window.css
+++ b/apps/desktop/src/renderer/views/chat-window.css
@@ -334,7 +334,8 @@ html[data-platform="darwin"] .sidebar-header {
-webkit-app-region: no-drag;
}
.account-panel,
-.action-menu {
+.action-menu,
+.action-submenu {
position: absolute;
padding: 7px;
background: var(--panel);
@@ -351,7 +352,8 @@ html[data-platform="darwin"] .sidebar-header {
.account-panel.compact {
bottom: 68px;
}
-.action-menu {
+.action-menu,
+.action-submenu {
width: 260px;
border-radius: var(--radius-l);
}
diff --git a/apps/desktop/src/renderer/views/section-menus.test.ts b/apps/desktop/src/renderer/views/section-menus.test.ts
index f306c03a..98d5e031 100644
--- a/apps/desktop/src/renderer/views/section-menus.test.ts
+++ b/apps/desktop/src/renderer/views/section-menus.test.ts
@@ -2,7 +2,7 @@ import assert from 'node:assert/strict'
import { test } from 'node:test'
import type { Bot } from '@shared/models'
import type { BotStore } from '../store/bot-store'
-import type { ActionItem } from './PanelMenus'
+import type { ActionItem } from './DesktopActionMenu'
import { moveToSectionItems, sectionHeaderItems, type SectionNaming } from './section-menus.ts'
/** A computer's store as the menus read it (`archived` is hidden, its section still counts), logging what they ask of it. */
diff --git a/apps/desktop/src/renderer/views/section-menus.ts b/apps/desktop/src/renderer/views/section-menus.ts
index 85fcdc07..20e6c0eb 100644
--- a/apps/desktop/src/renderer/views/section-menus.ts
+++ b/apps/desktop/src/renderer/views/section-menus.ts
@@ -2,7 +2,7 @@ import type { Bot } from '@shared/models'
import type { MenuItem } from '../components/Overlay'
import { sectionNames } from '../lib/roster-sections.ts'
import type { BotStore } from '../store/bot-store'
-import type { ActionItem } from './PanelMenus'
+import type { ActionItem } from './DesktopActionMenu'
/** An open section name dialog: its title, the name it starts with, and what Save does with the typed one. */
export interface SectionNaming {
diff --git a/docs/architecture/desktop-app.md b/docs/architecture/desktop-app.md
index b5813cb9..099b201e 100644
--- a/docs/architecture/desktop-app.md
+++ b/docs/architecture/desktop-app.md
@@ -186,3 +186,5 @@ Composer keyboard behavior, animation and durable draft storage, with a host-fre
regression fixture: [composer checks](../guides/composer.md).
Section headings and the unsectioned Bots group also drag up or down within their computer. Alt+Up/Down on a focused heading moves it one place. Dragging folds the groups temporarily; cancelling restores the order, and dropping saves it per computer on this device.
+
+Roster action submenus open beside their parent on hover, click, Enter or Right. They flip left near the window edge; a short hover delay keeps the path into the child stable. Left or Escape returns to the parent. This mouse-specific behavior is desktop-only: iPhone uses its native context menu, Android keeps touch submenus, and the terminal uses keyboard prompts.
diff --git a/docs/plans/roster-sections.md b/docs/plans/roster-sections.md
index c29366aa..8ca42949 100644
--- a/docs/plans/roster-sections.md
+++ b/docs/plans/roster-sections.md
@@ -68,7 +68,7 @@ section too.
| Client | Model | Header | Menus | Name entry | Folded state |
|---|---|---|---|---|---|
-| Desktop | `shared/models.ts` `Bot.section`, `normalizeBot` | modeled on `ComputerRosterSection` | `DesktopActionMenu` (`PanelMenus.tsx`), items from `views/section-menus.ts` (Move to section as submenu rows) | `Dialog` | `prefs.ts`, `collapsedRosterSections` |
+| Desktop | `shared/models.ts` `Bot.section`, `normalizeBot` | modeled on `ComputerRosterSection` | `views/DesktopActionMenu.tsx`, items from `views/section-menus.ts` (Move to section as a hover or keyboard submenu) | `Dialog` | `prefs.ts`, `collapsedRosterSections` |
| iPhone | `Bot.swift` `Bot.section: String?`; `HostClient.setSection` sends `null` to clear | modeled on `ComputerSection` | system `contextMenu` submenu (`.contextActions`) | `.codyncDialog` | `@AppStorage("collapsedRosterSections")` |
| Android | `HostClient.kt` `Bot.section`; `BotDraft.template()` leaves it out | modeled on iOS `ComputerSection` (`RosterSectionViews.kt`) | `contextActions` | `CodyncDialog` | `SharedPreferences` |
| Terminal | `tui/app/bot.rs` `Bot.section` | labels beside `PINNED` / `BOTS` in `view/roster.rs` | keys, listed in `view/help.rs` | `section_fields` sheet (`manage/fields.rs`) | in memory |
diff --git a/web/content/docs/bots.mdx b/web/content/docs/bots.mdx
index cc1e55a7..51e8affc 100644
--- a/web/content/docs/bots.mdx
+++ b/web/content/docs/bots.mdx
@@ -105,7 +105,7 @@ Each bot keeps a long-term memory across sessions, which you can read on its **M
Sections group a computer's bots under headings you name, such as Work and Personal. They need Codync 2.32.0 or newer on the computer.
-- **Move a bot into a section:** open the bot's menu (iPhone: touch and hold it; Desktop: right-click it) and choose **Move to section**, then a section, **New section…** or **Remove from section**. Terminal UI: `w`, then type the section's name, or leave it empty to take the bot out.
+- **Move a bot into a section:** open the bot's menu (iPhone: touch and hold it; Desktop: right-click it) and choose **Move to section**, then a section, **New section…** or **Remove from section**. On Desktop, hover over **Move to section** to open its submenu; clicking it or pressing `→` also opens it. Terminal UI: `w`, then type the section's name, or leave it empty to take the bot out.
- **Reorder sections:** drag a heading up or down (iPhone: touch and hold, then drag). Move custom sections above or below **Bots**; pinned bots stay on top. Each device remembers its own order. On Desktop, focus a heading and press `Alt+↑` or `Alt+↓`. Terminal UI: select a bot in the section and press `Alt+↑` or `Alt+↓`; its order lasts until you quit.
- **Fold a section:** tap or click its heading to fold its bots away. A folded heading shows their unread count. Each device keeps its own folds. Terminal UI: `z`, or click the section's label; its folds last until you quit.
- **Rename or remove a section:** touch and hold its heading (Desktop: right-click it) and choose **Rename section…** or **Remove section**. Its bots stay, without a section. Renaming it to another section's name merges the two. Terminal UI: `W`; an empty name removes the section.