Status Checks

What Is a Status Check?

A status check is tied to a process and includes a command, check interval, timeout, and an action to take when the check fails (do nothing, restart the process, or notify).

How Checks Work

• • Checks are defined at the project level and inherited by each workspace.
• • Each workspace can customize its own checks independently.
• • Edits to checks in a running workspace apply immediately.
• • Checks run in periodic background monitoring for running workspaces.
• • A process may have multiple checks.

GUI Configuration

• • In Workspace Settings, each status check row includes an On Fail selector.
• • none: store failed (red) status only.
• • notify: store failed status and send a desktop notification.
• • restart: store failed status and restart the linked process.

Status Output

• • Successful check: green status indicator.
• • Failed check or timeout: red status indicator.
• • Check output is available for inspection.
• • Process rows in the Run tab display check summaries.

Related Process States

Status checks are one layer of visibility. Process state provides additional context.

• • Running: process is alive.
• • Exited: process has stopped.
• • Idle: agent process is alive but no output for the configured interval.