Subshell Docs

Use Subshell

Manage your running sessions and the settings you use to launch them.

Start with Find your way around and Launch a subshell. Agents run on the selected machine, and their sessions remain available when you disconnect your browser.

Use Connect over SSH to open a terminal on another machine through one of your nodes.

Use Web previews & screens to check websites and graphical apps beside your agent. Its setup guides cover web previews, browser watching, and virtual displays on Linux and macOS.

Organize work

Workspaces arrange existing subshells in a layout. Presets save agent settings and optional launch defaults. Reusable Prompts store reusable task text that you can inject into a live session.

Use Clone and switch presets when you want a new session with related settings or need to change the preset used by an existing session.

Work with other people

Share a subshell explains view and edit access. Sharing a session doesn't share its notification subscriptions. Configure Notifications and Devices for the devices on which you want alerts.

Finish work

Read Session lifecycle before closing a subshell. Disconnecting a browser, stopping a process, and deleting a subshell have different consequences.

For agents coordinating with each other, use MCP and agent communication.

Edit on GitHub

Last updated on

On this page