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

# outerbounds app list

export const GCell = ({children, className}) => <div className={`grid-table-cell ${className || ""}`} role="cell">
    {children}
  </div>;

export const GTH = ({children, className}) => <div className={`grid-table-th ${className || ""}`} role="columnheader">
    {children}
  </div>;

export const GRow = ({children}) => <div className="grid-table-row" role="row">{children}</div>;

export const GBody = ({children}) => <div className="grid-table-body" role="rowgroup">{children}</div>;

export const GHead = ({children}) => <div className="grid-table-head" role="rowgroup">{children}</div>;

export const GTable = ({children, className, cols}) => <div className={`grid-table not-prose overflow-hidden rounded-2xl ${className || ""}`} style={{
  "--grid-table-cols": cols
}} role="table">
    {children}
  </div>;

## Usage

```bash theme={null}
outerbounds app list [OPTIONS]
```

## Description

Returns all deployments in the configured perimeter with their status and endpoint URLs.

## Options

<GTable cols="30% 20% 50%">
  <GHead>
    <GRow>
      <GTH>Option</GTH>
      <GTH>Default</GTH>
      <GTH>Description</GTH>
    </GRow>
  </GHead>

  <GBody>
    <GRow>
      <GCell>`--project`</GCell>

      <GCell />

      <GCell>Filter apps by project.</GCell>
    </GRow>

    <GRow>
      <GCell>`--branch`</GCell>

      <GCell />

      <GCell>Filter apps by branch.</GCell>
    </GRow>

    <GRow>
      <GCell>`--name`</GCell>

      <GCell />

      <GCell>Filter apps by name.</GCell>
    </GRow>

    <GRow>
      <GCell>`--tag`</GCell>

      <GCell />

      <GCell>Filter apps by tag. Format `--tag <KEY>=<VALUE>`. Example `--tag foo=bar --tag x=y`. If multiple tags are provided, the app must match all of them. Repeatable.</GCell>
    </GRow>

    <GRow>
      <GCell>`--format`</GCell>
      <GCell>`text`</GCell>
      <GCell>Format the output. Choices: `json`, `text`.</GCell>
    </GRow>

    <GRow>
      <GCell>`--auth-type`</GCell>

      <GCell />

      <GCell>Filter apps by auth type. Choices: `Browser`, `API`, `BrowserAndApi`.</GCell>
    </GRow>
  </GBody>
</GTable>

## Examples

**List everything in the perimeter**

```bash theme={null}
outerbounds app list
```

**Filter by project and branch**

```bash theme={null}
outerbounds app list --project my-project --branch main
```