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.

Settings → Agents: tell the menu list and the integrations apart

enes4384efa2075e
diff --git a/src/renderer/components/settings/IntegrationConsent.test.tsx b/src/renderer/components/settings/IntegrationConsent.test.tsx
index fc793200b..19f6f33d1 100644
--- a/src/renderer/components/settings/IntegrationConsent.test.tsx
+++ b/src/renderer/components/settings/IntegrationConsent.test.tsx
@@ -94,15 +94,24 @@ describe('the per-host question', () => {
})
describe('Settings → Agents', () => {
- it('has Enable / Decline & clean up per agent, and lists what the host kept', async () => {
+ it('shows each agent\'s state with only the action that changes it, and lists what the host kept', async () => {
vi.useFakeTimers()
try {
useSettings.setState({ settings: { ...DEFAULT_SETTINGS, agentIntegrations: answerIntegrationPrompt(['claude']) } })
render(<IntegrationSettings />)
for (const a of INTEGRATION_AGENT_IDS) expect(host.querySelector(`[data-testid="integration-row-${a}"]`)).toBeTruthy()
- const decline = host.querySelector('button[aria-label^="Turn off the Claude"]') as HTMLButtonElement
- click(decline)
+ const state = (a: string): string | null | undefined =>
+ host.querySelector(`[data-testid="integration-row-${a}-state"]`)?.textContent
+ expect(state('claude')).toBe('Installed')
+ expect(state('codex')).toBe('Not installed')
+ // An installed agent offers only Remove; a declined one only Install.
+ expect(host.querySelector('button[aria-label^="Install the Claude"]')).toBeNull()
+ expect(host.querySelector('button[aria-label^="Remove the Codex"]')).toBeNull()
+ const remove = host.querySelector('button[aria-label^="Remove the Claude"]') as HTMLButtonElement
+ click(remove)
expect(consent()?.agents?.claude).toBe('declined')
+ click(host.querySelector('button[aria-label^="Install the Codex"]') as HTMLButtonElement)
+ expect(consent()?.agents?.codex).toBe('enabled')
await act(async () => {
vi.advanceTimersByTime(500)
await Promise.resolve()
diff --git a/src/renderer/components/settings/IntegrationConsent.tsx b/src/renderer/components/settings/IntegrationConsent.tsx
index 6761c4c92..d6a7c3de2 100644
--- a/src/renderer/components/settings/IntegrationConsent.tsx
+++ b/src/renderer/components/settings/IntegrationConsent.tsx
@@ -140,8 +140,49 @@ export function HostIntegrationBanner({ hostKey }: { hostKey: string | null }):
)
}
+/** The state, said as what is on disk — "On"/"Off" read like the Add-menu switch below it. */
function choiceText(c: IntegrationChoice | undefined): string {
- return c === 'enabled' ? 'On' : c === 'declined' ? 'Off' : 'Not asked'
+ return c === 'enabled' ? 'Installed' : c === 'declined' ? 'Not installed' : 'Not set up yet'
+}
+
+/** One agent or SSH host: its state, and only the action(s) that would change it. */
+function IntegrationRow({
+ icon,
+ label,
+ choice,
+ onChoose,
+ testId
+}: {
+ icon?: React.ReactNode
+ label: string
+ choice: IntegrationChoice | undefined
+ onChoose: (c: IntegrationChoice) => void
+ testId: string
+}): React.JSX.Element {
+ return (
+ <div className="flex items-center gap-3 py-1" data-testid={testId}>
+ {icon}
+ <span className="flex-1 text-[13px] text-text">{label}</span>
+ <span className="text-[12px] text-muted" data-testid={`${testId}-state`}>
+ {choiceText(choice)}
+ </span>
+ {choice !== 'enabled' && (
+ <Button variant="primary" onClick={() => onChoose('enabled')} aria-label={`Install the ${label} integration`}>
+ Install
+ </Button>
+ )}
+ {choice === 'enabled' && (
+ <Button onClick={() => onChoose('declined')} aria-label={`Remove the ${label} integration and what nodeterm added`}>
+ Remove
+ </Button>
+ )}
+ {choice === undefined && (
+ <Button onClick={() => onChoose('declined')} aria-label={`Don't install the ${label} integration`}>
+ Don’t install
+ </Button>
+ )}
+ </div>
+ )
}
/** Settings → Agents: one row per agent, the per-host answers, and what the host kept. */
@@ -169,59 +210,33 @@ export function IntegrationSettings(): React.JSX.Element {
const hosts = Object.entries(integrationsOf(settings).hosts ?? {})
return (
<div className="space-y-2" data-testid="integration-settings">
- <p className="text-[12px] text-muted">
- {INTEGRATION_WRITES} {INTEGRATION_UNAVAILABLE}
- </p>
{status?.vetoed && (
<p className="text-[12px] text-muted">
This server was started with agent installs disabled, so nothing is written regardless of
these choices.
</p>
)}
- {INTEGRATION_AGENT_IDS.map((id) => {
- const c = agentChoice(settings, id)
- return (
- <div key={id} className="flex items-center gap-3 py-1" data-testid={`integration-row-${id}`}>
- <AgentIcon agentId={id} size={18} />
- <span className="flex-1 text-[13px] text-text">{labelOf(id)}</span>
- <span className="text-[12px] text-muted">{choiceText(c)}</span>
- <Button
- variant={c === 'enabled' ? 'primary' : 'default'}
- onClick={() => save(withAgentChoice(settings, id, 'enabled'))}
- aria-label={`Enable the ${labelOf(id)} integration`}
- >
- Enable
- </Button>
- <Button
- variant={c === 'declined' ? 'primary' : 'default'}
- onClick={() => save(withAgentChoice(settings, id, 'declined'))}
- aria-label={`Turn off the ${labelOf(id)} integration and remove what nodeterm added`}
- >
- Decline &amp; clean up
- </Button>
- </div>
- )
- })}
+ {INTEGRATION_AGENT_IDS.map((id) => (
+ <IntegrationRow
+ key={id}
+ icon={<AgentIcon agentId={id} size={18} />}
+ label={labelOf(id)}
+ choice={agentChoice(settings, id)}
+ onChoose={(c) => save(withAgentChoice(settings, id, c))}
+ testId={`integration-row-${id}`}
+ />
+ ))}
{hosts.length > 0 && (
<div className="pt-2">
- <div className="text-[12px] text-muted pb-1">SSH hosts</div>
+ <div className="text-[12px] text-muted pb-1">On SSH hosts</div>
{hosts.map(([host, c]) => (
- <div key={host} className="flex items-center gap-3 py-1" data-testid={`integration-host-${host}`}>
- <span className="flex-1 text-[13px] text-text">{host}</span>
- <span className="text-[12px] text-muted">{choiceText(c)}</span>
- <Button
- variant={c === 'enabled' ? 'primary' : 'default'}
- onClick={() => save(withHostChoice(settings, host, 'enabled'))}
- >
- Allow
- </Button>
- <Button
- variant={c === 'declined' ? 'primary' : 'default'}
- onClick={() => save(withHostChoice(settings, host, 'declined'))}
- >
- Decline &amp; clean up
- </Button>
- </div>
+ <IntegrationRow
+ key={host}
+ label={host}
+ choice={c}
+ onChoose={(next) => save(withHostChoice(settings, host, next))}
+ testId={`integration-host-${host}`}
+ />
))}
</div>
)}
diff --git a/src/renderer/components/settings/sections/AgentsSection.tsx b/src/renderer/components/settings/sections/AgentsSection.tsx
index 697ecda81..38f33a05c 100644
--- a/src/renderer/components/settings/sections/AgentsSection.tsx
+++ b/src/renderer/components/settings/sections/AgentsSection.tsx
@@ -62,12 +62,12 @@ import { IntegrationSettings } from '../IntegrationConsent'
const ROWS = {
integrations: {
- title: 'Agent integrations',
- keywords: ['integration', 'consent', 'hook', 'hooks', 'skill', 'skills', 'install', 'opt out', 'decline', 'clean up', 'ssh', 'host', 'agents.md', 'gemini.md']
+ title: 'Hooks & skills (integrations)',
+ keywords: ['agent integrations', 'integration', 'remove', 'uninstall', 'consent', 'hook', 'hooks', 'skill', 'skills', 'install', 'opt out', 'decline', 'clean up', 'ssh', 'host', 'agents.md', 'gemini.md']
},
agents: {
- title: 'Agents',
- keywords: ['agent', 'claude', 'codex', 'gemini', 'enable', 'disable', 'default']
+ title: 'Show in Add menus',
+ keywords: ['agent', 'claude', 'codex', 'gemini', 'enable', 'disable', 'show', 'hide', 'menu', 'default']
},
launchCommands: {
title: 'Launch commands',
@@ -455,16 +455,17 @@ export function AgentsSection({ isActive }: { isActive: boolean }): React.JSX.El
id="agents"
title="Agents"
description={agentChip
- ? `Enable or disable agents in the Add menus, and pick the default (${agentChip}).`
- : 'Enable or disable agents in the Add menus, and pick the default.'}
+ ? `Choose which agents the Add menus show and the default (${agentChip}), and whether nodeterm installs its hooks and skills into each agent.`
+ : 'Choose which agents the Add menus show and the default, and whether nodeterm installs its hooks and skills into each agent.'}
isActive={isActive}
searchEntries={ENTRIES}
>
- <SearchableRow {...ROWS.integrations}>
- <FieldRow label="Agent integrations" description="What nodeterm may write into each agent CLI’s own configuration, on this machine and on each SSH host." control={null} />
- <IntegrationSettings />
- </SearchableRow>
<SearchableRow {...ROWS.agents}>
+ <FieldRow
+ label="Show in Add menus"
+ description="Which agents appear in the Add menus, the Dock and ⌘K, and which one “New agent” opens. Hiding one only changes the menus — nothing is installed or removed."
+ control={null}
+ />
<div className="space-y-2">
{rows.map((row) => {
const enabled = isAgentEnabled(settings, row.id)
@@ -484,10 +485,10 @@ export function AgentsSection({ isActive }: { isActive: boolean }): React.JSX.El
</Button>
<SegmentedPill<'enabled' | 'disabled'>
value={enabled ? 'enabled' : 'disabled'}
- ariaLabel={`${row.label} availability`}
+ ariaLabel={`Show ${row.label} in the Add menus`}
options={[
- { value: 'enabled', label: 'Enabled' },
- { value: 'disabled', label: 'Disabled' }
+ { value: 'enabled', label: 'Shown' },
+ { value: 'disabled', label: 'Hidden' }
]}
onChange={(v) => update(setAgentEnabled(settings, row.id, v === 'enabled'))}
/>
@@ -496,6 +497,18 @@ export function AgentsSection({ isActive }: { isActive: boolean }): React.JSX.El
})}
</div>
</SearchableRow>
+ <SearchableRow {...ROWS.integrations}>
+ <FieldRow
+ label="Hooks & skills (integrations)"
+ description={
+ 'Files nodeterm installs into each agent CLI’s own config: a status hook (RUNNING / NEEDS YOU badges, notifications) ' +
+ 'and two skills (canvas control, reading linked nodes). Remove deletes exactly what nodeterm added. ' +
+ 'Without it the agent still runs in a terminal, just without those features. This is separate from the menu list above.'
+ }
+ control={null}
+ />
+ <IntegrationSettings />
+ </SearchableRow>
<SearchableRow {...ROWS.launchCommands}>
<FieldRow
label="Launch commands"