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
import { useEffect, useState } from 'react'
import { useSshServers } from '../../../state/sshServers'
import type { SshServer } from '@shared/ssh'
import { SettingsSection } from '../SettingsSection'
import { SearchableRow } from '../SearchableRow'
import { FieldRow } from '../FieldRow'
import { Button } from '@renderer/ui/Button'
import { Input } from '@renderer/ui/Input'
import { uuid } from '@renderer/lib/uuid'
import { Switch } from '@renderer/ui/Switch'
import { useSettings } from '../../../state/settings'
import { isWindowsPlatform } from '@shared/platform-utils'
import { isBrowserRuntime } from '../../../bridge/runtime'
const ROWS = {
servers: {
title: 'Saved SSH servers',
keywords: [
'ssh', 'remote', 'server', 'host', 'connect', 'identity', 'key',
'test', 'folder', 'directory', 'cwd', 'working directory'
]
},
windowsAgent: {
title: 'Keep unlocked keys in the Windows ssh-agent',
keywords: ['ssh-agent', 'agent', 'passphrase', 'key', 'windows', 'AddKeysToAgent', 'ssh-add', 'prompt']
}
}
/** The native SSH transport (and with it this switch) is the Windows desktop's; a browser tab's
* SSH is the server's business, whatever OS the viewer runs. */
function showsWindowsAgentRow(): boolean {
return typeof navigator !== 'undefined' && !isBrowserRuntime() && isWindowsPlatform()
}
const ENTRIES = showsWindowsAgentRow() ? Object.values(ROWS) : [ROWS.servers]
export function SshSection({ isActive }: { isActive: boolean }): React.JSX.Element {
const sshServers = useSshServers((s) => s.servers)
const agentAddKeys = useSettings((s) => s.settings.windowsSshAgentAddKeys)
const updateSettings = useSettings((s) => s.update)
const [sshDraft, setSshDraft] = useState<SshServer | null>(null)
const [importMsg, setImportMsg] = useState<string | null>(null)
const [testMsg, setTestMsg] = useState<string | null>(null)
const [testing, setTesting] = useState(false)
useEffect(() => {
void useSshServers.getState().hydrate()
}, [])
// Import named hosts from ~/.ssh/config. Dedupe against saved servers by user@host:port and
// skip hosts without a User (can't form a usable connection); the user can add those by hand.
const importFromConfig = async () => {
// Surface a clear message in every case — a silent no-op (e.g. the IPC bridge missing
// because the app wasn't restarted after an update) is worse than an error.
if (typeof window.nodeTerminal.ssh.importCandidates !== 'function') {
setImportMsg('Import unavailable — fully quit and reopen the app to load the update.')
return
}
setImportMsg('Importing…')
try {
const key = (s: { user?: string; host: string; port?: number }) =>
`${s.user ?? ''}@${s.host}:${s.port ?? 22}`
const candidates = await window.nodeTerminal.ssh.importCandidates()
const withUser = candidates.filter((c) => c.user)
const skipped = candidates.length - withUser.length
const seen = new Set(useSshServers.getState().servers.map(key))
const fresh = withUser.filter((c) => !seen.has(key(c)))
for (const c of fresh) {
await useSshServers.getState().save({
id: uuid(),
label: c.label,
host: c.host,
user: c.user as string,
port: c.port,
identityFile: c.identityFile
})
}
setImportMsg(
candidates.length === 0
? 'No hosts found in ~/.ssh/config'
: `${fresh.length ? `Imported ${fresh.length} server${fresh.length === 1 ? '' : 's'}` : 'No new servers to import'}${
skipped ? ` · skipped ${skipped} without a user` : ''
}`
)
} catch (err) {
setImportMsg(`Import failed: ${err instanceof Error ? err.message : String(err)}`)
}
}
const saveDisabled =
!sshDraft ||
!sshDraft.label.trim() ||
!sshDraft.host.trim() ||
!sshDraft.user.trim()
/**
* Open a ControlMaster to the draft's endpoint, then close it — the same connect a project (or a
* host attachment) makes, so a green answer here means those will work too. It runs under its
* OWN scope id, never a project's: joining a live project connection would report success
* without testing anything, and disconnecting afterwards would drop that project's terminals.
*/
const testConnection = async (): Promise<void> => {
if (!sshDraft || saveDisabled || testing) return
const connectionId = `ssh-settings-test-${sshDraft.id}`
setTesting(true)
setTestMsg(`Connecting to ${sshDraft.label}…`)
try {
await window.nodeTerminal.sshProject.connect(
connectionId,
sshDraft,
sshDraft.remoteCwd?.trim() || '~'
)
setTestMsg('Connection successful.')
} catch (error) {
setTestMsg(`Connection failed: ${error instanceof Error ? error.message : String(error)}`)
} finally {
// Always: a partially-established master left behind would be silently reused by the next
// test (and by anything else asking for this id), reporting a stale answer.
await window.nodeTerminal.sshProject.disconnect(connectionId).catch(() => {})
setTesting(false)
}
}
return (
<SettingsSection
id="ssh"
title="Remote (SSH)"
description="Saved SSH servers appear under “New remote”, and can host nodes on a local canvas. Each also becomes a machine in Accounts, where its own isolated Codex logins live. Opening remote terminals over SSH is free."
isActive={isActive}
searchEntries={ENTRIES}
>
<SearchableRow {...ROWS.servers}>
<div className="space-y-4">
{sshServers.map((server) => (
<div
key={server.id}
className="flex items-center justify-between gap-4 rounded-md border border-border p-3"
>
<div className="min-w-0">
<div className="truncate text-sm text-text">
{server.label} — {server.user}@{server.host}
{server.port && server.port !== 22 ? `:${server.port}` : ''}
</div>
<div className="truncate text-xs text-muted">
Default folder: {server.remoteCwd || '~'}
</div>
</div>
<div className="flex shrink-0 gap-2">
<Button
onClick={() => {
setTestMsg(null)
setSshDraft(server)
}}
>
Edit
</Button>
<Button
variant="ghost"
onClick={() => void useSshServers.getState().remove(server.id)}
>
Delete
</Button>
</div>
</div>
))}
{sshDraft ? (
<div className="space-y-2 rounded-md border border-border p-3">
<FieldRow
label="Label"
control={
<Input
className="w-56"
placeholder="e.g. Prod box"
value={sshDraft.label}
onChange={(e) => setSshDraft({ ...sshDraft, label: e.target.value })}
/>
}
/>
<FieldRow
label="Host"
control={
<Input
className="w-56"
placeholder="e.g. example.com"
value={sshDraft.host}
onChange={(e) => setSshDraft({ ...sshDraft, host: e.target.value })}
/>
}
/>
<FieldRow
label="User"
control={
<Input
className="w-56"
placeholder="e.g. root"
value={sshDraft.user}
onChange={(e) => setSshDraft({ ...sshDraft, user: e.target.value })}
/>
}
/>
<FieldRow
label="Port"
control={
<Input
className="w-24"
type="number"
value={sshDraft.port ?? 22}
onChange={(e) =>
setSshDraft({ ...sshDraft, port: Number(e.target.value) || 22 })
}
/>
}
/>
<FieldRow
label="Default folder"
description="Where browsing this machine starts: the folder “New remote” opens at, and the one Test connection dials."
control={
<Input
className="w-72 font-mono"
placeholder="~/projects/my-project"
value={sshDraft.remoteCwd ?? '~'}
onChange={(e) => setSshDraft({ ...sshDraft, remoteCwd: e.target.value })}
/>
}
/>
<FieldRow
label="Identity file"
description="Optional private key passed with -i."
control={
<div className="flex gap-2">
<Input
className="w-56"
placeholder="~/.ssh/id_ed25519"
value={sshDraft.identityFile ?? ''}
onChange={(e) =>
setSshDraft({ ...sshDraft, identityFile: e.target.value })
}
/>
<Button
onClick={async () => {
const file = await window.nodeTerminal.dialog.selectFile()
if (file) setSshDraft({ ...sshDraft, identityFile: file })
}}
>
Choose…
</Button>
</div>
}
/>
<FieldRow
label="Extra ssh args"
description="Optional advanced flags, e.g. -o StrictHostKeyChecking=no."
control={
<Input
className="w-56"
placeholder="(optional)"
value={sshDraft.extraArgs ?? ''}
onChange={(e) => setSshDraft({ ...sshDraft, extraArgs: e.target.value })}
/>
}
/>
{testMsg ? <p className="text-xs text-muted">{testMsg}</p> : null}
<div className="flex flex-wrap justify-end gap-2 pt-1">
<Button variant="ghost" onClick={() => setSshDraft(null)}>
Cancel
</Button>
<Button disabled={saveDisabled || testing} onClick={() => void testConnection()}>
{testing ? 'Testing…' : 'Test connection'}
</Button>
<Button
variant="primary"
disabled={saveDisabled}
onClick={async () => {
await useSshServers.getState().save({
...sshDraft,
remoteCwd: sshDraft.remoteCwd?.trim() || '~'
})
setSshDraft(null)
setTestMsg(null)
}}
>
Save
</Button>
</div>
</div>
) : (
<div className="flex items-center gap-2">
<Button
onClick={() =>
setSshDraft({
id: uuid(),
label: '',
host: '',
user: '',
port: 22,
remoteCwd: '~'
})
}
>
Add server
</Button>
<Button variant="ghost" onClick={() => void importFromConfig()}>
Import from ~/.ssh/config
</Button>
{importMsg && <span className="text-xs text-muted">{importMsg}</span>}
</div>
)}
</div>
</SearchableRow>
{showsWindowsAgentRow() ? (
<SearchableRow {...ROWS.windowsAgent}>
<FieldRow
label="Keep unlocked keys in the Windows ssh-agent"
description="Off by default. On, a key you unlock with its passphrase for an SSH project is also added to the Windows OpenSSH Authentication Agent service (when it is running), so later connections — and your own ssh — stop asking. Windows stores the key, encrypted for your account, until you remove it (ssh-add -d, or ssh-add -D for all); it stays after nodeterm quits and after a restart. Hosts whose ~/.ssh/config says AddKeysToAgent yes get this without the switch."
control={
<Switch
checked={agentAddKeys === true}
onChange={(v) => void updateSettings({ windowsSshAgentAddKeys: v })}
ariaLabel="Keep unlocked keys in the Windows ssh-agent"
/>
}
/>
</SearchableRow>
) : null}
</SettingsSection>
)
}