Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

fix(team): a headless computer is told how to sign its team engines in (#2728)

lingrdd13c182b2af3
diff --git a/cli/src/cli.ts b/cli/src/cli.ts
index 500782353..b7423b306 100644
--- a/cli/src/cli.ts
+++ b/cli/src/cli.ts
@@ -217,6 +217,14 @@ Machine:
harness flash [flags] re-flash a plugged-in circle device over USB. Flags go straight to the
flasher: --detect-only, --port, --version, --yes, --erase-nvs
+Team account (the separate "harnessteam" user that runs Swarm work on this computer):
+ harness team setup make the account, its daemon and its engines, so teammates' agents cannot read
+ your files; run again to repair (--sign-in-again: a new sign-in)
+ harness team status whether it exists and runs, its sign-in, privacy check and engines
+ harness team on | off a computer used only for agents runs Swarm work only (on), or signs back in as
+ your own computer (off)
+ harness team remove delete the account, its home folder and its daemon
+
Grid (the fleet of AI engines the \`grid\` CLI serves — needs \`grid\` on PATH):
harness grid login sign in to your grid reusing THIS computer's Autonomous account —
no second browser, no second approval
diff --git a/cli/src/team/engines.spec.ts b/cli/src/team/engines.spec.ts
index 8bfa4b6ea..833f354ef 100644
--- a/cli/src/team/engines.spec.ts
+++ b/cli/src/team/engines.spec.ts
@@ -54,6 +54,15 @@ describe('the team account\'s engines', () => {
const linux = engineLines(engines({ claude: { installed: true, signedIn: false }, codex: { installed: true, signedIn: false } }), ago, 'linux').join('\n')
expect(linux).toContain('open a terminal on this computer\'s Harness Team machine')
expect(linux).not.toContain('Mac')
+ // A computer used over a terminal has no Harness app to open a terminal in (headless run, 2026-11-03): the same
+ // sign-in, from the terminal the person is already in.
+ expect(linux).toContain('Or from a terminal on this computer, as harnessteam:')
+ expect(linux).toContain('sudo -u harnessteam -H bash -lc claude')
+ expect(lines).toContain('Or from a terminal on this Mac, as harnessteam:')
+ // Windows has no sudo: its sign-in stays the Harness terminal's.
+ expect(engineLines(engines({ claude: { installed: true, signedIn: false } }), ago, 'win32').join('\n')).not.toContain('sudo -u')
+ // Why a server reads "not signed in": the subscription is lent through this computer's own daemon while it runs.
+ expect(linux).toContain('when that is not running (harness start, or harness service install), there is nothing to lend')
expect(lines).toContain(' claude Claude Code')
expect(lines).not.toContain('codex login')
expect(lines).toContain('Your own sign-ins are not copied into the team account')
diff --git a/cli/src/team/engines.ts b/cli/src/team/engines.ts
index 54fa73e9a..264af2695 100644
--- a/cli/src/team/engines.ts
+++ b/cli/src/team/engines.ts
@@ -15,6 +15,7 @@ import { userInfo } from 'node:os'
import { join, win32 } from 'node:path'
import { engineAccount, type EngineAccount } from '../lib/engineAccount.js'
import { readTeamConfig, type TeamConfig } from './config.js'
+import { TEAM_USER } from './layout.js'
import { readTeamStatus, writeTeamStatus, type TeamStatus } from './privacy.js'
import { teamRelayed } from './relay.js'
@@ -160,7 +161,21 @@ export function engineLines(engines: TeamEngines | undefined, ago: (at: number)
lines.push('', ` To sign the team account's engines in, once: in Harness, open a terminal on ${computer}'s Harness Team machine`,
' (it is listed among your machines), and run there:')
for (const { name, signIn } of unsigned) lines.push(` ${signIn.padEnd(28)}${name}`)
+ // A computer used over a terminal has no Harness app to open a terminal in (headless run, 2026-11-03): the same sign-in,
+ // from the terminal the person is already in.
+ if (platform !== 'win32') {
+ lines.push(` Or from a terminal on ${computer}, as ${TEAM_USER}:`)
+ const terminal = unsigned.map(({ engine, name }) => ({
+ command: `sudo -u ${TEAM_USER} -H bash -lc ${engine === 'claude' ? 'claude' : "'codex login --device-auth'"}`, name,
+ }))
+ const width = Math.max(...terminal.map(({ command }) => command.length)) + 3
+ for (const { command, name } of terminal) lines.push(` ${command.padEnd(width)}${name}`)
+ }
lines.push(' Your own sign-ins are not copied into the team account; each engine bills the account you sign in with.')
+ // Why a server reads "not signed in" with a subscription on the account: the relay that lends it lives in this
+ // computer's own daemon (team/relay.ts), so nothing is lent while that daemon is not running.
+ lines.push(" An engine the account has not signed in uses your subscription through this computer's Harness while it runs;",
+ ' when that is not running (harness start, or harness service install), there is nothing to lend.')
}
return lines
}