Subshell Docs

Agents

Choose the harness that launches your coding agent in a subshell.

Built-in harnesses

HarnessCLI binaryMCP setup
Claude CodeclaudeAutomatic per-session configuration.
CodexcodexAutomatic per-session configuration.
OpenCodeopencodeAutomatic per-session configuration.
Gemini CLIgeminiOne-time registration on the execution host.
Qwen CodeqwenOne-time registration on the execution host.
ClineclineOne-time registration on the execution host.
Open InterpreterinterpreterOne-time registration on the execution host.
OpenHandsopenhandsOne-time registration on the execution host.
OpenClawopenclawNot wired yet; its MCP registration is Gateway-scoped.
Grok BuildgrokOne-time registration on the execution host.
Hermes AgenthermesOne-time registration on the execution host.
pipiInstall an adapter and register MCP on the execution host.
Oh My PiompAutomatic per-session configuration.
TerminalYour shellNo agent MCP integration.

A harness plugin describes how Subshell launches a program. Installing that plugin doesn't make the program available on every machine.

Availability

The administrator installs and enables plugins for the instance. The server checks whether each node can find the corresponding binary. A disabled plugin or missing binary prevents launch on that node.

See Install an agent CLI for detection and Plugins for instance management.

Agent accounts

Authenticate the CLI under the OS account that runs the agent. A browser sign-in to Subshell doesn't authenticate the coding agent with its provider.

Follow delegated work

When a supported harness starts subagents, follow them beneath their parent subshell in the sidebar. See Subagents for the collapse controls, naming, and which harnesses support switching views.

Next steps

Choose an agent guide above, then save Presets.

Edit on GitHub

Last updated on

On this page