# dsc list
Lists all Discourse installs known to dsc, optionally filtered by tags.
```
dsc list [--format <format>] [--tags <tag1,tag2,...>] [--open] [--verbose]
```
## Formats
`--format` (or `-f`) accepts:
- `text` (default)
- `markdown`
- `markdown-table`
- `json`
- `yaml`
- `csv`
- `urls` — one base URL per line, useful for piping
## Flags
- `--tags` — comma or semicolon separated, matches any tag (case-insensitive).
- `--open` (or `-o`) — open each listed Discourse base URL in a browser tab/window.
- `--verbose` (or `-v`) — include empty results and verbose listing details.
## Examples
```bash
# List all installs as a markdown table
dsc list --format markdown-table
# Open all installs tagged "client" in the browser
dsc list --open --tags client
# Pipe URLs to another command
## dsc list tidy
Orders the `dsc.toml` file entries alphabetically by name. Collects any missing full names by querying the Discourse URLs.
```bash
dsc list tidy
```