desk ps

List every source and target recorded in the active store, including agents that have exited. Entries are shown newest first in a Docker-style table.

desk ps
desk ps --no-trunc

Columns

Column	Meaning
AGENT ID	First 12 characters of the Desk management-record ID.
AGENT	Agent type.
STATUS	Saved lifecycle state and current PID observation, when applicable.
PID	Recorded process ID; - when no process was recorded.
PACK ID	Associated source pack ID, shortened to 12 characters.
NAME	Source or target workspace’s directory name.

--no-trunc shows full agent and pack IDs. move --resume accepts unique agent-ID prefixes for retained entries that are still prepared.

A packed source has status packed. A target normally passes through prepared, starting and running, then ends in exited or failed.

For saved running records, Desk checks whether the PID is present. It can display running (PID present), exited (unobserved), or unknown. PID presence alone cannot establish process identity after an interrupted Desk process; another process could have reused that PID.

This command reports Desk’s management history. It does not discover unrelated agents, kill processes, or discard old records. It accepts no positional arguments.

The store defaults to ~/.desk/store. Set DESK_HOME to use $DESK_HOME/store.