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 { Tooltip } from '../components/Tooltip'
import { IconChevronDown, IconChevronRight, IconClose } from '../components/icons'
import { Handle, NodeResizer, Position, useReactFlow, type NodeProps } from '@xyflow/react'
import { NODE_MIN_SIZES } from '../lib/nodeSizing'
import { toggleCollapsed, type CanvasNode } from '../state/workspace'
import { NodeColorSwatches } from '../components/NodeColorSwatches'
import { ColumnPill } from '../components/kanban/ColumnPill'
import { NoteMarkdown } from '../components/NoteMarkdown'
import { relativeTime } from '../lib/relativeTime'
import { useSettings } from '../state/settings'
import { backedFillStyle } from '@shared/canvas-backing'
/**
* A sticky note node: a colored, resizable card with free-text content.
* No PTY — purely a visual note for organizing the canvas (handy for ADHD users).
*/
export function StickyNode({ id, data, selected }: NodeProps<CanvasNode>) {
const { updateNodeData, deleteElements, setNodes } = useReactFlow()
const [showColors, setShowColors] = useState(false)
// Settings → Appearance → Sticky note background (issue #1113); 0 = the old see-through look.
const backing = useSettings((s) => s.settings.stickyNoteBacking)
/**
* The title is a plain SPAN until it is clicked, exactly as on a terminal node.
*
* It used to be a permanent `<input class="term-node__title">`, and that class is `flex: 1` — so
* the input covered the whole header strip. Everything in that strip was therefore a text field:
* clicking to pick the note up put a caret in the title instead, and there was no bare header
* left to grab. Reported 2026-08-09 ("the click area is full width, it should only be the name").
* The terminal's `.term-node__title-text` is content-width, which is the behaviour being matched.
*/
const [editingTitle, setEditingTitle] = useState(false)
/** The value editing started with, so Escape can put it back. */
const [titleBefore, setTitleBefore] = useState('')
/**
* The body is a rendered-markdown view until it is clicked, then the same textarea as before
* (blur renders it again) — the sticky half of issue #144, where an agent-synced note (tickets,
* status) should read as a document, not as raw markup in a textarea.
*/
const [editingText, setEditingText] = useState(false)
const collapsed = !!data.collapsed
const stampAt = data.textUpdatedAt as number | undefined
// The stamp is the accountability surface a confirm dialog was traded for, so its label must
// not FREEZE at "just now" on an idle canvas (React Flow memoizes node renders): tick it every
// minute while a stamp is showing. `relativeTime` (not formatTimeAgo) — it takes `now` as a
// parameter, has a day unit, and clamps a peer-clock-skewed future timestamp to "just now".
const [now, setNow] = useState(() => Date.now())
useEffect(() => {
if (stampAt === undefined) return
const t = setInterval(() => setNow(Date.now()), 60_000)
return () => clearInterval(t)
}, [stampAt])
const toggleCollapse = () => setNodes((ns) => toggleCollapsed(ns as CanvasNode[], [id]))
return (
<>
{/* Sibling of the root: .sticky-node is overflow:hidden and would clip the half-pill. */}
<ColumnPill nodeId={id} />
<div
className={`sticky-node${selected ? ' selected' : ''}${collapsed ? ' collapsed' : ''}`}
style={{ ...backedFillStyle(data.color, '22', backing), borderColor: data.color }}
>
<NodeResizer minWidth={NODE_MIN_SIZES.sticky.width} minHeight={NODE_MIN_SIZES.sticky.height} isVisible={selected && !collapsed} color={data.color} />
{/* Note-link handles: drag to/from a terminal node to attach this note as context. */}
<Handle
id="link-out"
type="source"
position={Position.Right}
className="bridge-handle bridge-handle--out"
data-tip="Link out — drag to a terminal to attach this note as context"
/>
<Handle
id="link-in"
type="target"
position={Position.Left}
className="bridge-handle bridge-handle--in"
data-tip="Link in — drop a link here to attach this note as context"
/>
<div className="sticky-node__header" style={{ background: `${data.color}33` }}>
<Tooltip label={collapsed ? 'Expand' : 'Collapse'}>
<button
className="term-node__collapse"
aria-label={collapsed ? 'Expand' : 'Collapse'}
onClick={toggleCollapse}
>
{collapsed ? <IconChevronRight /> : <IconChevronDown />}
</button>
</Tooltip>
<Tooltip label="Color">
<button
className="term-node__color"
style={{ background: data.color }}
aria-label="Color"
onClick={() => setShowColors((v) => !v)}
/>
</Tooltip>
{showColors && (
<NodeColorSwatches
className="color-popover"
selected={data.color as string | undefined}
onPick={(c) => {
updateNodeData(id, { color: c })
setShowColors(false)
}}
/>
)}
{editingTitle ? (
<input
className="term-node__title nodrag"
value={data.title}
spellCheck={false}
autoFocus
onChange={(e) => updateNodeData(id, { title: e.target.value })}
// Every exit commits what is on screen — the edits are live, so there is nothing to
// save — except Escape, which puts back the value editing started with.
onBlur={() => setEditingTitle(false)}
onKeyDown={(e) => {
if (e.key === 'Enter') {
e.preventDefault()
setEditingTitle(false)
} else if (e.key === 'Escape') {
e.preventDefault()
updateNodeData(id, { title: titleBefore })
setEditingTitle(false)
}
}}
/>
) : (
<span
className="term-node__title-text nodrag"
title="Click to rename"
onClick={() => {
setTitleBefore((data.title as string) ?? '')
setEditingTitle(true)
}}
>
{(data.title as string) || 'Note'}
</span>
)}
{/* Pushes the close button back to the right edge now that the title is content-width — and
it is deliberately NOT `nodrag`, so this is the bare strip of header the note is picked
up by. That grab area is what the permanent full-width input used to swallow. Absent
while editing, since the input takes the `flex: 1` role itself. */}
{!editingTitle && <span className="term-node__spacer" />}
<Tooltip label="Close">
<button
className="term-node__close"
aria-label="Close"
onClick={() => deleteElements({ nodes: [{ id }] })}
>
<IconClose />
</button>
</Tooltip>
</div>
{editingText ? (
<textarea
className="sticky-node__body nodrag nowheel"
value={data.text ?? ''}
placeholder="Write a note…"
spellCheck={false}
autoFocus
// A hand edit clears the agent-sync stamp: it vouches for "an agent wrote this", which
// stops being true on the first keystroke.
onChange={(e) =>
updateNodeData(id, { text: e.target.value, textUpdatedAt: undefined, textUpdatedBy: undefined })
}
onBlur={() => setEditingText(false)}
onKeyDown={(e) => {
if (e.key === 'Escape') {
e.preventDefault()
setEditingText(false)
}
}}
/>
) : (
<div
className="sticky-node__view nodrag nowheel"
role="button"
tabIndex={0}
onClick={(e) => {
// A link click opens externally (main's will-navigate guard); it must not ALSO flip
// the note into edit mode under the reader.
if ((e.target as HTMLElement).closest('a')) return
// Finishing a drag-selection fires a click at the common ancestor — flipping into the
// textarea there would destroy the selection the user just made to copy it.
const sel = window.getSelection()
if (sel && !sel.isCollapsed) return
setEditingText(true)
}}
onKeyDown={(e) => {
if (e.key === 'Enter' && (e.target as HTMLElement).tagName !== 'A') {
e.preventDefault()
setEditingText(true)
}
}}
>
{((data.text as string) ?? '') !== '' ? (
<NoteMarkdown text={data.text as string} className="sticky-node__md" />
) : (
<span className="sticky-node__placeholder">Write a note…</span>
)}
</div>
)}
{typeof stampAt === 'number' && (
<div className="sticky-node__stamp" title={new Date(stampAt).toLocaleString()}>
↻ {(data.textUpdatedBy as string) || 'agent'} · {relativeTime(stampAt, now)}
</div>
)}
</div>
</>
)
}