# pier ls

> What's in the environment; a kind (apps, sites, pg, buckets, volumes, domains) narrows it

URL: https://pier.run/docs/cli/reference/ls

```bash
pier ls [<kind>]
```

What's in the environment; a kind (apps, sites, pg, buckets, volumes, domains) narrows it.

## Arguments

| Argument | Required | Description                                                    |
| -------- | -------- | -------------------------------------------------------------- |
| `<kind>` | no       | Narrow to one kind: apps, sites, pg, buckets, volumes, domains |

[Global flags](/docs/cli/reference#global-flags) apply to every command.

## Examples

```bash
pier ls                     # every kind in the current environment, sectioned
pier ls apps                # one kind, full columns
pier ls pg -e staging       # another environment, this command only
pier ls apps --json | jq '.items[].name'
```

## Behaviour

* Rows are targets. A single-target app is listed by its name; a multi-target app is listed
  once per target (`api/main`, `api/stage`). The `NAME` column is a [ref](/docs/cli/refs)
  that other commands accept as written.
* Domains are listed but are not refs; routes and variables have their own nouns
  (`pier routes`, `pier vars`).