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.
TypeScript adhdagent-orchestrationai-agentscanvasclaude-codecodexcoding-agentsdeveloper-toolselectrongeminilinuxmacosmultiplexeropencodeparallel-agentsterminalterminal-emulatorterminal-multiplexertmuxworkspace-manager
// @vitest-environment jsdom
//
// The usage popover's bulk "Move N sessions": on an account row with sessions, it offers the OTHER
// accounts of the same machine and hands the pick to Canvas. The rules pinned here: the row's own
// account is never offered as a target, a row with nothing on it shows no control, and the pick
// carries the source, the target and its label.
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import { act } from 'react'
import { createRoot, type Root } from 'react-dom/client'
import { UsageIndicator } from './UsageIndicator'
import { useSettings } from '../state/settings'
import { useProjects } from '../state/projects'
import { DEFAULT_SETTINGS, type ClaudeUsage } from '@shared/types'
const usage = (email: string): ClaudeUsage => ({
limits: [
{
kind: 'session',
group: 'session',
usedPercent: 100,
severity: null,
resetsAt: null,
windowMinutes: null,
scopeLabel: null,
isActive: true
}
],
session: null,
weekly: null,
email,
updatedAt: 0,
status: 'ok'
})
let root: Root
let host: HTMLElement
const onMove = vi.fn()
beforeEach(() => {
vi.stubGlobal('IS_REACT_ACT_ENVIRONMENT', true)
onMove.mockReset()
useSettings.setState({
settings: {
...DEFAULT_SETTINGS,
claudeAccounts: [
{ id: 'w', label: 'Work', email: '[email protected]', createdAt: 0 },
{ id: 'p', label: 'Personal', email: '[email protected]', createdAt: 0 }
]
},
hydrated: true
})
useProjects.setState({ projects: [{ id: 'p1', name: 'local', nodes: [] } as never], activeProjectId: 'p1' })
;(window as unknown as { nodeTerminal: unknown }).nodeTerminal = {
usage: {
fetch: async (id?: string) => usage(id ? `${id}@example.com` : '[email protected]'),
onUpdate: () => () => {},
providers: async () => [],
remote: async () => []
},
settings: { save: async () => {} }
}
})
afterEach(() => {
act(() => root.unmount())
host.remove()
useSettings.setState({ settings: DEFAULT_SETTINGS })
vi.unstubAllGlobals()
})
type Move = { from: string | undefined; count: number; scopeKey: string } | null
const element = (counts: Record<string, number>, accountMove: Move = null) => (
<UsageIndicator
countAccountSessions={(id) => counts[id ?? 'system'] ?? 0}
onMoveSessions={onMove}
accountMove={accountMove}
/>
)
async function renderOpen(counts: Record<string, number>, accountMove: Move = null): Promise<void> {
host = document.createElement('div')
document.body.appendChild(host)
root = createRoot(host)
await act(async () => {
root.render(element(counts, accountMove))
})
await act(async () => (host.querySelector('.usage-pill') as HTMLButtonElement).click())
}
const buttons = (): HTMLButtonElement[] => [...host.querySelectorAll('button')]
describe('usage popover — Move N sessions', () => {
it('moves an account’s sessions to another account of the same machine', async () => {
await renderOpen({ w: 3 })
const move = buttons().find((b) => b.textContent === '⇄ Move 3 sessions')!
expect(move).toBeTruthy()
await act(async () => move.click())
const targets = buttons()
.filter((b) => b.textContent?.startsWith('→ '))
.map((b) => b.textContent)
// Its own account is never a target; the system login and the other account are.
expect(targets).toEqual(['→ [email protected]', '→ Personal'])
await act(async () => buttons().find((b) => b.textContent === '→ Personal')!.click())
expect(onMove).toHaveBeenCalledWith('w', 'p', 'Personal')
})
it('moves the system account’s sessions (source undefined)', async () => {
await renderOpen({ system: 1 })
await act(async () => buttons().find((b) => b.textContent === '⇄ Move 1 session')!.click())
await act(async () => buttons().find((b) => b.textContent === '→ Work')!.click())
expect(onMove).toHaveBeenCalledWith(undefined, 'w', 'Work')
})
it('shows no control on a row with no sessions', async () => {
await renderOpen({})
expect(buttons().some((b) => b.textContent?.startsWith('⇄ Move'))).toBe(false)
})
})
// A move takes seconds, and the sessions it is moving keep their OLD account until each one lands.
// Reopening the popover meanwhile used to offer "Move 3 sessions" again — counting the sessions
// already on their way — and the click was then silently refused (one bulk move at a time).
describe('usage popover — while a move is running', () => {
it('the source row says the move is under way, and offers nothing to click', async () => {
await renderOpen({ w: 3 }, { from: 'w', count: 3, scopeKey: '' })
const moving = buttons().find((b) => b.textContent === '⇄ Moving 3 sessions…')
expect(moving).toBeTruthy()
expect(moving!.disabled).toBe(true)
expect(buttons().some((b) => b.textContent?.startsWith('⇄ Move '))).toBe(false)
})
it('keeps saying so even once the source row has emptied out', async () => {
await renderOpen({}, { from: 'w', count: 3, scopeKey: '' })
expect(buttons().find((b) => b.textContent === '⇄ Moving 3 sessions…')).toBeTruthy()
})
it('every other row’s move is disabled, since a second move would be refused', async () => {
await renderOpen({ w: 3, p: 2 }, { from: 'w', count: 3, scopeKey: '' })
const other = buttons().find((b) => b.textContent === '⇄ Move 2 sessions')!
expect(other.disabled).toBe(true)
await act(async () => other.click())
expect(buttons().some((b) => b.textContent?.startsWith('→ '))).toBe(false)
expect(onMove).not.toHaveBeenCalled()
})
it('a move on ANOTHER machine does not relabel this machine’s row as moving', async () => {
await renderOpen({ w: 3 }, { from: 'w', count: 3, scopeKey: 'u@h' })
expect(buttons().some((b) => b.textContent?.startsWith('⇄ Moving'))).toBe(false)
expect(buttons().find((b) => b.textContent === '⇄ Move 3 sessions')!.disabled).toBe(true)
})
it('when the move ends, the row offers the fresh count again', async () => {
await renderOpen({ w: 3 }, { from: 'w', count: 3, scopeKey: '' })
await act(async () => root.render(element({ w: 1, p: 2 }, null)))
const move = buttons().find((b) => b.textContent === '⇄ Move 1 session')!
expect(move.disabled).toBe(false)
})
})