Skip to main content
Display the status of cordon instances — running processes, listening ports, and service health.

​
Usage

cordon status [OPTIONS] [NAME]
cordon status list
Argument / OptionDescription
[NAME]Named installed service. Looks up that service file to determine config path and status.
listList all installed services and standalone cordon processes.
--config, -cCheck the instance using this config file. Mutually exclusive with --scope.
--scopeproject or user; selects which config file to inspect.
--verbose, -vShow detailed instance information.
--quiet, -qSuppress output and use exit code only. Cannot be combined with names, subcommands, or --verbose.
Shows information about:
  • Running cordon processes
  • Listening ports
  • Installed service status
  • Health endpoint responses
  • Token enforcement status and warnings (missing tokens, unenforced scopes)
When ./cordon.toml is missing, cordon status falls back to installed services:
  • If exactly one installed service exists, it inspects that service automatically
  • If multiple installed services exist, it shows the service list and asks you to pick one by name

​
Quiet mode

cordon status -q
cordon status --quiet
Suppresses all output and communicates via exit code only:
Exit codeMeaning
0Cordon is running and healthy
1Cordon is not responding, or config exists but can’t be parsed
If no config file is found (cordon not configured for this project/scope), exits 0 — nothing to check. Quiet mode performs a fast health check: 50ms timeout with one retry (20ms delay between attempts). It skips service discovery and process scanning — just loads the config, reads the port, and hits the /health endpoint. This is used by the Claude Code health-check hook to detect when cordon is down. It’s also useful in scripts, CI, and shell prompts: 
cordon status -q || echo "cordon is down"

​
Examples

# Check current project config
cordon status

# Check user-scope config
cordon status --scope user

# Check a named installed service
cordon status user

# List every service/process Cordon can find
cordon status list

# Show detailed health, PID, routes, and service metadata
cordon status --verbose