Socotra
CLI · command

socotra status

Show the alignment status between the YAML definition and the filesystem.


Synopsis

socotra status [--full] [--output text|json]

Options

OptionTypeDefaultDescription
--outputtext | jsontextOutput format
--fullboolfalseRun full pipeline comparison instead of summary

Behavior

Without --full:

  • Parses YAML only (no filesystem scan).
  • Shows lastApply timestamp from .socotra/state.json.
  • Sync status is "unknown" unless a full status was recently cached.

With --full:

  • Runs the full comparison pipeline.
  • Shows "In Sync" (green) or "Drifted" (yellow).

Examples

socotra status
socotra status --full
socotra status --output json
status (basic)
{
  "version": "1.1",
  "solution": "MyApp",
  "modules": 3,
  "lastApply": "2026-06-17T10:30:00Z",
  "syncStatus": "unknown"
}
status --full
{
  "inSync": true,
  "driftCount": 0,
  "projects": [
    { "name": "MyApp.Orders.Domain", "exists": true, "status": "matched" }
  ]
}
Schema 1.1 · CLI 1.0