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 { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
import fs from 'fs'
import os from 'os'
import path from 'path'
// Guard for a bug that bit a developer for real: `startServer` merges the managed agent hooks
// into the user's REAL agent config dirs (~/.claude/settings.json et al), pointing them at
// `<dataDir>/agent-hooks/<agent>.sh`. A test booting the server with a temp `dataDir` and then
// removing it therefore left a DANGLING hook behind in the developer's own settings.json —
// which Claude Code runs on every tool call, so every later session on that machine died.
// `installHooks: false` is the opt-out; every server test must pass it. This test keeps the
// flag honest (and the default — a real deployment does need the hooks installed).
vi.mock('../../src/core/agents/hooks', async (importOriginal) => ({
...(await importOriginal<typeof import('../../src/core/agents/hooks')>()),
installManagedAgentHooks: vi.fn(),
removeManagedAgentHooks: vi.fn()
}))
import { startServer } from '../../src/server/index'
import { installManagedAgentHooks } from '../../src/core/agents/hooks'
describe('startServer: managed hook install is opt-out-able', () => {
let dataDir: string
let testHome: string
let close: (() => Promise<void>) | undefined
const realHome = process.env.HOME
beforeEach(() => {
dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'nt-e2e-hookguard-'))
testHome = fs.mkdtempSync(path.join(os.tmpdir(), 'nt-e2e-hookguard-home-'))
process.env.HOME = testHome
vi.mocked(installManagedAgentHooks).mockClear()
})
afterEach(async () => {
await close?.()
close = undefined
if (realHome === undefined) delete process.env.HOME
else process.env.HOME = realHome
fs.rmSync(dataDir, { recursive: true, force: true })
fs.rmSync(testHome, { recursive: true, force: true })
})
const boot = (installHooks?: boolean) =>
startServer({
port: 0,
host: '127.0.0.1',
dataDir,
rendererDir: path.join(dataDir, 'no-renderer'),
insecureHttp: false,
passwordSeed: 'hookguard-pw',
...(installHooks === undefined ? {} : { installHooks })
})
it('does NOT touch the real agent config dirs when installHooks is false', async () => {
const srv = await boot(false)
close = srv.close
expect(installManagedAgentHooks).not.toHaveBeenCalled()
expect(fs.existsSync(path.join(testHome, '.claude', 'skills', 'get-linked-context', 'SKILL.md'))).toBe(false)
expect(fs.existsSync(path.join(testHome, '.codex', 'AGENTS.md'))).toBe(false)
}, 30_000)
// Issue #744: the default no longer writes into a user's agent config without consent.
it('a NEW install (nothing of ours on disk, no answer) writes nothing — it is asked first', async () => {
const srv = await boot(undefined)
close = srv.close
expect(installManagedAgentHooks).not.toHaveBeenCalled()
expect(fs.existsSync(path.join(testHome, '.claude'))).toBe(false)
expect(fs.existsSync(path.join(testHome, '.codex'))).toBe(false)
}, 30_000)
it('installs for the agents the user enabled — skills in their own dirs, nothing in AGENTS.md', async () => {
fs.writeFileSync(
path.join(dataDir, 'settings.json'),
JSON.stringify({ agentIntegrations: { agents: { claude: 'enabled', codex: 'enabled' }, origin: 'asked' } })
)
const srv = await boot(undefined)
close = srv.close
expect(installManagedAgentHooks).toHaveBeenCalledOnce()
expect([...vi.mocked(installManagedAgentHooks).mock.calls[0][0]].sort()).toEqual(['claude', 'codex'])
expect(fs.existsSync(path.join(testHome, '.claude', 'skills', 'get-linked-context', 'SKILL.md'))).toBe(true)
expect(fs.existsSync(path.join(testHome, '.codex', 'skills', 'get-linked-context', 'SKILL.md'))).toBe(true)
expect(fs.existsSync(path.join(testHome, '.codex', 'AGENTS.md'))).toBe(false)
}, 30_000)
it('an existing install (our hook scripts on disk) is grandfathered as enabled at boot', async () => {
fs.mkdirSync(path.join(testHome, '.nodeterm', 'agent-hooks'), { recursive: true })
fs.writeFileSync(path.join(testHome, '.nodeterm', 'agent-hooks', 'claude.sh'), '#!/bin/sh\n')
const srv = await boot(undefined)
close = srv.close
expect(installManagedAgentHooks).toHaveBeenCalledOnce()
const saved = JSON.parse(fs.readFileSync(path.join(dataDir, 'settings.json'), 'utf8'))
expect(saved.agentIntegrations.origin).toBe('grandfathered')
}, 30_000)
})