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

# appz list

> Learn how to list all recent deployments for the current Appz Project using the `appz list` CLI command.

export const GlobalOptionsComponent = ({command}) => <div>
    <h2><a href="#global-options">Global Options</a></h2>
    <p>These general options can be applied when using the <code>{command}</code> command:</p>
    <ul>
    <li><code>--cwd</code></li>
    <li><code>--debug</code></li>
    <li><code>--global-config</code></li>
    <li><code>--help</code></li>
    <li><code>--local-config</code></li>
    <li><code>--no-color</code></li>
    <li><code>--scope</code></li>
    <li><code>--token</code></li>
    </ul>

    <p>For detailed information on these global options and their applications, refer to the <a href="/cli/global-options">options section</a>.</p>
    </div>;

The `appz list` command, which can be shortened to `appz ls`, provides a list of recent deployments for the currently-linked Appz Project.

## Usage

```bash terminal theme={null}
appz list
```

> Executing the `appz list` command to retrieve information about multiple deployments for the currently-linked Appz Project.

## Extended Usage

```bash terminal theme={null}
appz list [project-name]
```

> Using the `appz list` command to retrieve information about deployments for a specific Appz Project.

```bash terminal theme={null}
appz list [project-name] [--meta foo=bar]
```

> Using the `appz list` command to retrieve information about deployments filtered by metadata.

## Unique Options

These options are specific to the `appz list` command.

### Meta

The `--meta` option, abbreviated as `-m`, allows filtering results based on Appz Project metadata.

```bash terminal theme={null}
appz list --meta key1=value1 key2=value2
```

> Using the `appz list` command with the `--meta` option.

### Yes

The `--yes` option can be used to bypass questions when setting up a new Appz Project. The questions will be automatically answered using the default scope and the current directory for the Appz Project name and location.

```bash terminal theme={null}
appz list --yes
```

> Using the `appz list` command with the `--yes` option.

<GlobalOptionsComponent command={'appz list'} />