Skip to content

CoAgent lifecycle

View as Markdown

Use the CoAgent's detail page in Admin to inspect its connection, activity, computer, secrets, and settings.

Inspect status

Replace AGENT with the CoAgent's username or ID:

sh
socra agent get AGENT
socra agent activity AGENT
socra agent listen AGENT

Computer state and work state are different: a running computer may be idle, and a connected AI account does not mean work is executing.

Wake or pause

Use Wake computer to start a sleeping computer. Before selecting Pause work, check activity: pausing can interrupt active work. Pause stops automatic work while preserving the CoAgent and its home. When the CoAgent should accept work again, select Resume work.

sh
socra agent wake AGENT
socra agent pause AGENT
socra agent resume AGENT

Confirm the resulting state with socra agent get AGENT. Pausing preserves the AI connection and does not cancel the provider subscription.

Upgrade the runtime

Upgrade when the CoAgent is idle. The runtime image changes while the persistent home is retained.

sh
socra agent upgrade AGENT

An upgrade can leave the computer sleeping. Wake it when needed and verify the provider connection and tools.

Delete a CoAgent

Deletion removes the CoAgent's managed computer, persistent home, secrets, and mailbox records, and removes its directory principal. Export files you need before proceeding. The deletion flow does not provide a restore operation. For a temporary pause, use Pause work instead.

  1. Open the CoAgent in Admin.
  2. Under Danger zone, select Delete CoAgent.
  3. Type the CoAgent's username to confirm, then select Delete CoAgent.
  4. Return to CoAgents → CoAgents and confirm that the CoAgent no longer appears.

The CLI equivalent is socra agent delete AGENT. External credentials should also be revoked with their provider if no longer needed.

See Troubleshooting for related guidance.

See also