Skip to content

Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.

feat(kanban): default OFF, dedicated global shortcut, opt-in Cmd+Shift+B flip

Alexb02b40d205a0
diff --git a/src/renderer/canvas/Canvas.tsx b/src/renderer/canvas/Canvas.tsx
index c2f0fc7b2..a093f2040 100644
--- a/src/renderer/canvas/Canvas.tsx
+++ b/src/renderer/canvas/Canvas.tsx
@@ -6540,9 +6540,16 @@ export function Canvas() {
'app.settings': () => { setSettingsSection(undefined); setSettingsOpen(true); return true },
'app.shortcutsPanel': () => { setShortcutsOpen((v) => !v); return true },
'view.kanbanToggle': () => {
- const omniEnabled = isOmniKanbanEnabled(useSettings.getState().settings)
- if (omniEnabled) {
- // Ensure the active lane is not stale when the overview opens (live nodes → serialized p.nodes).
+ // Global board is an overlay — any toggle while it's open closes it.
+ if (isGlobalKanbanOpen()) {
+ useViewMode.getState().toggleGlobalKanban()
+ return true
+ }
+ const settings = useSettings.getState().settings
+ const omniEnabled = isOmniKanbanEnabled(settings)
+ const asDefault = settings.omniKanbanAsDefault === true
+ if (omniEnabled && asDefault) {
+ // Opt-in: Cmd+Shift+B opens Omni when the user lives in the global view.
if (!isGlobalKanbanOpen()) commitActiveToStore()
useViewMode.getState().toggleGlobalKanban()
} else {
@@ -6552,6 +6559,12 @@ export function Canvas() {
}
return true
},
+ 'view.globalKanbanToggle': () => {
+ if (!isOmniKanbanEnabled(useSettings.getState().settings)) return false
+ if (!isGlobalKanbanOpen()) commitActiveToStore()
+ useViewMode.getState().toggleGlobalKanban()
+ return true
+ },
'view.focusMode': () => { toggleFocusMode(); return true },
'panel.explorer': () => { showExplorer('toggle'); return true },
'panel.sourceControl': () => { setScOpen((v) => !v); return true },
diff --git a/src/renderer/components/TabBar.tsx b/src/renderer/components/TabBar.tsx
index 3918b40bd..ac1ce8abf 100644
--- a/src/renderer/components/TabBar.tsx
+++ b/src/renderer/components/TabBar.tsx
@@ -370,16 +370,20 @@ export function TabBar({
onClick={(e) => {
e.stopPropagation() // a tab click switches projects, this only flips the view
const vm = useViewMode.getState()
- const omni = isOmniKanbanEnabled(useSettings.getState().settings)
- if (omni) {
- if (vm.globalKanban || viewFor(vm, p.id) === 'kanban') {
- if (vm.globalKanban) vm.toggleGlobalKanban()
- if (viewFor(vm, p.id) === 'kanban') vm.toggle(p.id)
- } else {
- vm.toggleGlobalKanban()
- }
+ const settings = useSettings.getState().settings
+ const omni = isOmniKanbanEnabled(settings)
+ const asDefault = settings.omniKanbanAsDefault === true
+ // Closing: global overlay is exclusive — any board toggle while it's open closes it.
+ if (vm.globalKanban) {
+ vm.toggleGlobalKanban()
+ return
+ }
+ if (omni && asDefault) {
+ vm.toggleGlobalKanban()
} else {
- vm.toggle(p.id)
+ // Per-project board for this tab (also closes an open per-project board)
+ if (viewFor(vm, p.id) === 'kanban') vm.toggle(p.id)
+ else vm.toggle(p.id)
}
}}
>
diff --git a/src/renderer/components/settings/sections/BehaviorSection.tsx b/src/renderer/components/settings/sections/BehaviorSection.tsx
index 582e718cb..d26d73e0f 100644
--- a/src/renderer/components/settings/sections/BehaviorSection.tsx
+++ b/src/renderer/components/settings/sections/BehaviorSection.tsx
@@ -20,6 +20,10 @@ const ROWS = {
title: 'Omni Kanban (global swimlanes)',
keywords: ['omni', 'kanban', 'swimlane', 'global', 'overview', 'board', 'project']
},
+ omniKanbanDefault: {
+ title: 'Omni as default for Cmd+Shift+B',
+ keywords: ['omni', 'kanban', 'global', 'default', 'shortcut', 'cmd', 'shift', 'b']
+ },
gridSize: { title: 'Grid size', keywords: ['grid', 'size', 'snap'] },
nodeSize: {
title: 'Default node size',
@@ -100,16 +104,29 @@ export function BehaviorSection({ isActive }: { isActive: boolean }): React.JSX.
<SearchableRow {...ROWS.omniKanban}>
<FieldRow
label="Omni Kanban (global swimlanes)"
- description="When enabled, the kanban board shows all open projects as stacked swimlanes in one overview. Cmd+1..9 jumps to swimlanes, clicking a project pill jumps as well. Disable to keep per-project tabs."
+ description="When enabled, the global Kanban overview is available via its dedicated shortcut (Settings → Keyboard Shortcuts → Toggle global kanban). Default OFF — existing users see no change."
control={
<Switch
- checked={settings.omniKanbanEnabled ?? true}
+ checked={settings.omniKanbanEnabled === true}
onChange={(v) => update({ omniKanbanEnabled: v })}
ariaLabel="Omni Kanban"
/>
}
/>
</SearchableRow>
+ <SearchableRow {...ROWS.omniKanbanDefault}>
+ <FieldRow
+ label="Make Omni the default for Cmd+Shift+B"
+ description="When enabled, Cmd+Shift+B opens the global overview instead of the per-project board. The dedicated global shortcut always opens Omni regardless. Opt-in, per user."
+ control={
+ <Switch
+ checked={settings.omniKanbanAsDefault === true}
+ onChange={(v) => update({ omniKanbanAsDefault: v })}
+ ariaLabel="Omni as default"
+ />
+ }
+ />
+ </SearchableRow>
<SearchableRow {...ROWS.gridSize}>
<FieldRow
label="Grid size"
diff --git a/src/renderer/state/viewMode.ts b/src/renderer/state/viewMode.ts
index 2865c326a..f14f88e46 100644
--- a/src/renderer/state/viewMode.ts
+++ b/src/renderer/state/viewMode.ts
@@ -68,13 +68,12 @@ export function viewFor(s: Pick<ViewModeState, 'viewByProject' | 'defaultView'>,
/**
* Feature flag: does the global swimlane overview exist at all?
* `settings.omniKanbanEnabled` is the *feature* toggle (Settings → Behavior → Omni Kanban,
- * default ON, `true` when the key is absent for existing installs). `globalKanban` below is the
- * *view* toggle (whether the overview is currently shown). The two have opposite defaults
- * deliberately: the feature is on, the view is off until the user opens it. Use this helper
- * instead of spelling `!== false` inline — five call sites were doing it.
+ * default OFF — no silent behavior change for existing users). `globalKanban` below is the
+ * *view* toggle (whether the overview is currently shown). Use this helper instead of
+ * spelling the check inline.
*/
export function isOmniKanbanEnabled(settings: { omniKanbanEnabled?: boolean }): boolean {
- return settings.omniKanbanEnabled !== false
+ return settings.omniKanbanEnabled === true
}
function readGlobalKanban(): boolean {
diff --git a/src/shared/keybindings.ts b/src/shared/keybindings.ts
index 8ce269922..ddcf9fe9d 100644
--- a/src/shared/keybindings.ts
+++ b/src/shared/keybindings.ts
@@ -43,6 +43,7 @@ export type CommandId =
| 'app.settings'
| 'app.shortcutsPanel'
| 'view.kanbanToggle'
+ | 'view.globalKanbanToggle'
| 'view.focusMode'
| 'panel.explorer'
| 'panel.sourceControl'
@@ -105,6 +106,8 @@ export const COMMAND_DEFINITIONS: readonly CommandDefinition[] = [
defaultBindings: both('Cmd+Slash'), allowInTerminal: true },
{ id: 'view.kanbanToggle', title: 'Toggle kanban board', group: 'General', scope: 'app',
defaultBindings: both('Cmd+Shift+B'), allowInTerminal: true },
+ { id: 'view.globalKanbanToggle', title: 'Toggle global kanban (Omni)', group: 'General', scope: 'app',
+ defaultBindings: both(), allowInTerminal: true },
// Focus mode fills the window with one node — most naturally invoked from INSIDE the terminal
// being enlarged, hence allowInTerminal. Scope stays 'canvas': over the kanban board or while
// typing in an input there is no node geometry for the toggle to act on (the pre-registry
diff --git a/src/shared/types.ts b/src/shared/types.ts
index 0a24375a7..7c3ef4cd1 100644
--- a/src/shared/types.ts
+++ b/src/shared/types.ts
@@ -1217,8 +1217,13 @@ export interface Settings {
defaultProjectView: 'canvas' | 'kanban'
/** Global swimlane kanban overview (Omni-Kanban): when enabled, the kanban board shows all
* open projects as stacked swimlanes instead of per-project tabs. Toggle in Settings →
- * Behavior. Default ON for new installs; existing settings.json without the key migrates to ON. */
+ * Behavior. Default OFF — no silent behavior change for existing users; `globalKanban`
+ * (the view flag) is only honored when this is true. */
omniKanbanEnabled: boolean
+ /** When enabled, Cmd+Shift+B (view.kanbanToggle) opens the global Omni board instead of the
+ * per-project board. The dedicated global shortcut (view.globalKanbanToggle) always opens
+ * Omni regardless of this setting. Opt-in, per user — default OFF. */
+ omniKanbanAsDefault: boolean
/** New-worktree path template, resolved relative to the repository root. Supports `$repoName`
* (`$reponame` and `$defaultFolderName` aliases) plus `$branch`; both `$x` and `${x}` forms.
* A missing branch token is appended automatically. */
@@ -1524,7 +1529,8 @@ export const DEFAULT_SETTINGS: Settings = {
sidebarCollapsedItems: {},
sidebarGrouping: 'project',
defaultProjectView: 'canvas',
- omniKanbanEnabled: true,
+ omniKanbanEnabled: false,
+ omniKanbanAsDefault: false,
worktreePathTemplate: DEFAULT_WORKTREE_PATH_TEMPLATE,
panHoverDelay: 600,
doubleClickFocus: true,