shelbi detach
View as markdownshelbi detach [OPTIONS] [CLIENT_ID]Shelbi runs a single long-lived session that the daemon owns, and more than one
client can attach to it at once: terminal windows and the desktop app today,
and later a client attaching to a remote session. shelbi detach disconnects clients from that session without stopping any
work. Each detached client stops rendering and drops its connections, while every
session and agent keeps running in the background.
Detaching is not quitting. shelbi quit ends a project's
sessions (and shelbi quit --all stops the whole hub); detach leaves all of it
running so you can come back to it. Inside the dashboard the same actions live in
the command palette as Detach (leave Shelbi running in the background),
Detach Other Clients (disconnect every other window attached to this
session), Quit Project, and Quit Shelbi.
Reattaching
Plain shelbi reattaches to the running
session (and starts one if none is running), so after a detach you simply run
shelbi again to pick up where you left off. (shelbi attach
is a different command: it puts your terminal on one workspace's session.)
Arguments
| Argument | Type | Default | Description |
|---|---|---|---|
[CLIENT_ID] | string | all clients | Detach only the client with this id (from shelbi detach --list). Omit to detach every attached client. |
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--list | bool | false | List the attached clients (id, kind, host, project, attach time) without detaching any. |
--root <PATH> | string | install-time default / $SHELBI_ROOT / ~/.shelbi | Override the Shelbi root directory. The flag wins over both the env var and the compile-time default. |
-p, --project <PROJECT> | string | env / cwd lookup | Accepted as a global flag but ignored: detach is hub-wide, not per-project. |
shelbi detach exits 0 whether or not any client was attached. With no
running session it reports No clients attached., and an id that isn't attached
reports No client '<id>' attached.. It exits non-zero only if it can't reach the
running daemon's control socket. The --list table shows - in the PROJECT
column for a client with no project, such as the desktop app.
Examples
Detach every attached client:
shelbi detach
# Detached 2 clients.List the attached clients without detaching:
shelbi detach --list
# ID KIND HOST PROJECT ATTACHED
# k3f9a2 tui studio alpha 2026-10-07T18:04:11Z (pid 40321)
# q8d1c7 tui laptop alpha 2026-10-07T18:05:52Z (pid 9981)Detach just one client by id:
shelbi detach q8d1c7
# Detached 1 client.See also
shelbi attach— attach your terminal to a single workspace's session full-screen (a different concept: that is a per-workspace view, not session-level detach).shelbi reload— reload the dashboard and orchestrator in place after installing a new binary.