# 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 -f urls --tags alpha | xargs -n1 xdg-open
```

## 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
```
