> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codezero.io/llms.txt
> Use this file to discover all available pages before exploring further.

# cordon status

> Show running cordon instances and their health.

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

## Usage

```bash theme={null}
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

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

```bash theme={null}
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](/guides/claude-code#health-check-hook) to detect when cordon is down. It's also useful in scripts, CI, and shell prompts:

```bash theme={null}
cordon status -q || echo "cordon is down"
```

## Examples

```bash theme={null}
# 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
```