Harness Notes

Commands

Updated 2026-10-21

On this page

The command for each task, in each harness. Pick what you are working with, then read across: commands you type in your shell or a script and commands you type inside an open session are listed separately. Commands for renaming sessions are on Thread naming and importing from another harness on Migration.

From your shell

Commands you run in a terminal or script, outside a session.

TaskCodex CLIchecked at 0.162.1Claude Codechecked at 2.1.296Cursor Agentchecked at 2026.10.12-d47ca18OpenCode 2.xchecked at 2.0.28
Set up
Install

codex app-server daemon bootstrap

Install durable local app-server management for SSH-driven use.

1 note

--remote-control starts it with remote control on.

———
Sign in or pair

codex remote-control pair

Create and print a short-lived manual pairing code.

1 note

Experimental. The daemon must already be running.

———
Configure———

opencode service set <key> <value> [<env-value>]

Change a service setting.

1 note

Changing a setting stops the server.

opencode service unset <key> [<name>]

Reset a service setting to its default.

Use
Show details———

opencode service get [<key>] [<name>]

Read service settings such as host, port or password.

Check status

codex app-server daemon version

Print the local CLI and running app-server versions as JSON.

1 note

Reports versions only, not pid or uptime.

claude daemon status

Print the supervisor's pid, version, uptime and worker count.

1 note

Exits 1 when no supervisor runs.

—

opencode service status

Show the background server's status.

Show logs—

claude daemon logs

Follow the supervisor log until Ctrl+C.

——
Start or run

codex app-server daemon start

Start the local app-server daemon if it is not already running.

codex remote-control

Start remote control through the managed daemon, falling back to the foreground.

1 note

Experimental. --no-daemon runs an embedded app-server in the foreground until Ctrl-C.

codex remote-control start

Start the app-server daemon with remote control enabled.

1 note

Experimental; --json.

claude daemon run [json-path]

Run the supervisor in the foreground of this terminal.

agent worker [--pool [name]] start

Run a self-hosted Cloud Agent worker on this machine.

1 note

Personal worker, or a team pool with --pool. --management-addr serves health and metrics endpoints.

agent worker controller --spawn <hook> (--pool <name>... | --all-pools) [--warm-idle <count>]

Watch a pool's pending requests and start or wake workers through a hook.

opencode serve [--hostname] [--port] [--cors <origin>]

Run the API and web server in the foreground.

opencode service start

Start the shared background server.

opencode acp [--login]

Start an Agent Client Protocol server over stdio.

Validate——

agent worker debug

Run preflight checks for worker sign-in, privacy, routing and visibility.

—
Change
Enable

codex app-server daemon enable-remote-control

Enable remote control for future starts and a running managed daemon.

———
Disable

codex app-server daemon disable-remote-control

Disable remote control for future starts and a running managed daemon.

———
Update

codex app-server daemon update

Replace the daemon package.

1 note

May interrupt running work. --from-cli pins this CLI's package; -y requires --from-cli. Added in 0.155.0.

———
Reload———

opencode reload

Reload configuration without restarting the server.

1 note

Running sessions pick it up at the next step.

Restart

codex app-server daemon restart

Restart the local app-server daemon.

——

opencode service restart

Restart the background server.

Remove
Shut down

codex app-server daemon stop

Stop the local app-server daemon.

codex remote-control stop

Stop the app-server daemon.

1 note

Experimental; --json.

claude daemon stop [--any] [--keep-workers]

Stop the supervisor and the sessions it hosts.

1 note

--keep-workers leaves sessions running for the next supervisor.

—

opencode service stop

Stop the background server.

Uninstall—

claude daemon uninstall

Remove the background service registration.

1 note

Service install is disabled in this version, so this only cleans up an earlier registration. Not documented.

——

Inside a session

Slash commands you type into an open session.

TaskCodex CLIchecked at 0.162.1Claude Codechecked at 2.1.296Cursor Agentchecked at 2026.10.12-d47ca18OpenCode 2.xchecked at 2.0.28
Change
Update

/daemon

Show the background-server connection and offer to update it.

1 note

Confirming exits Codex and may interrupt work. Added in 0.156.0.

———
Reload———

/reload

Reload configuration from the interface.

Restart———

/restart

Restart the background service from the interface.

1 note

Only offered when connected to the managed service.

Notes and sources

Codex CLI
  • The shell CLI installs and removes plugins but has no enable, disable, update or validate command; the /plugins browser can switch plugins on or off.
  • --worktree starts new sessions in a managed Git worktree and works with codex fork given an explicit session; resume, queue, archive, unarchive and delete reject it at run time.
  • MCP protocol capabilities are recorded in mcp.json; these records cover the operator commands.
  • codex-cli-0.162.1 help observation, live observation, checked 2026-10-14
  • Codex developer commands, Documentation, checked 2026-10-15
Claude Code
  • Some plugin authoring and evaluation commands are newer than the public reference, so each command keeps its live help evidence.
  • Plugin installs that run a marketplace-declared command need --accept-command <sha256> without a TTY.
  • Interactive commands are recorded separately from their shell equivalents.
  • 2.1.304 adds /auto-mode-setup across Bedrock, Vertex, Foundry, Claude apps gateway and telemetry-disabled sessions; help output was corrected for several flags, and plugin validate no longer predicts where mod hooks run. Existing command help observations retain their versions.
  • claude plugin can also be written claude plugins.
Cursor Agent
  • Nested --help at this version prints the top-level help, so subcommand syntax for plugin marketplaces and in-session commands comes from the docs and changelog.
  • agent env, agent cloud and agent automations exist behind feature flags and are not recorded.
OpenCode 2.x
  • @opencode/cli 2.x runs one shared background service per user, managed with opencode service. Session sharing is not supported yet.
  • 2.1 restores archiving through client.session.update({ sessionID, archived: true|false }) and archive filtering in client.session.list. These are SDK/HTTP operations, not newly claimed shell subcommands.
  • 2.1 adds editable saved-grant action/resource patterns through client.permission.saved.update / PATCH /api/permission/saved/:id. Action is a tool/action name, not an allow/deny effect.
  • 2.1.1 fixes provider reasoning variant generation after package normalization; other command observations retain their earlier help/source versions.
pi
  • Shell MCP commands always use the built-in MCP and do not load extensions. In-session behaviour is documented, not live-probed.
  • pi-1.2.0 help observation, live observation, checked 2026-10-14
  • pi 1.2.0 documentation, Documentation, checked 2026-10-15