cordon status

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

Usage

cordon status [OPTIONS] [NAME]
cordon status list

Argument / Option	Description
`[NAME]`	Named installed service. Looks up that service file to determine config path and status.
`list`	List all installed services and standalone cordon processes.
`--config`, `-c`	Check the instance using this config file. Mutually exclusive with `--scope`.
`--scope`	`project` or `user`; selects which config file to inspect.
`--verbose`, `-v`	Show detailed instance information.
`--quiet`, `-q`	Suppress 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 code	Meaning
0	Cordon is running and healthy
1	Cordon 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

Getting Started

Configuration

Guides

CLI Reference

Security

Usage

Quiet mode

Examples

​Usage

​Quiet mode

​Examples

Usage

Quiet mode

Examples