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

# voicegw projects / voicegw project

> List all configured projects or show details for a single project.

# voicegw projects / voicegw project

List all configured projects or show details for a single project.

## Purpose

The `projects` command lists every project defined in the gateway configuration, showing their name, tags, daily budget, and default stack. The `project` command shows full details for a single project, including today's spend if cost tracking is enabled.

## Syntax

```bash theme={null}
# List all projects
voicegw projects [OPTIONS]

# Show a single project
voicegw project <PROJECT_ID> [OPTIONS]
```

## Options (projects)

| Flag       | Short | Type     | Default | Description                                         |
| ---------- | ----- | -------- | ------- | --------------------------------------------------- |
| `--config` | `-c`  | `string` | `null`  | Path to `voicegw.yaml`. Auto-discovered if omitted. |

<h2 id="project-detail">
  Options (project)
</h2>

| Argument     | Type     | Required | Description                |
| ------------ | -------- | -------- | -------------------------- |
| `PROJECT_ID` | `string` | yes      | The project ID to display. |

| Flag       | Short | Type     | Default | Description                                         |
| ---------- | ----- | -------- | ------- | --------------------------------------------------- |
| `--config` | `-c`  | `string` | `null`  | Path to `voicegw.yaml`. Auto-discovered if omitted. |

## Output (projects)

A table with columns:

| Column            | Description                               |
| ----------------- | ----------------------------------------- |
| **ID**            | Project identifier (e.g., `tonys-pizza`). |
| **Name**          | Human-readable name.                      |
| **Tags**          | Space-separated tags.                     |
| **Budget/day**    | Daily budget in USD, or `-` if unlimited. |
| **Default Stack** | Named stack, or `-` if none.              |

## Output (project)

A Rich panel showing:

* Project name and description.
* Tags, default stack, and daily budget.
* Today's spend and request count (if cost tracking is enabled).

## Examples

### List all projects

```bash theme={null}
voicegw projects
```

```
                    Projects
┌──────────────┬──────────────┬────────────┬────────────┬───────────────┐
│ ID           │ Name         │ Tags       │ Budget/day │ Default Stack │
├──────────────┼──────────────┼────────────┼────────────┼───────────────┤
│ tonys-pizza  │ Tony's Pizza │ production │ $10.00     │ premium       │
│ sushi-bot    │ Sushi Bot    │ staging    │ $5.00      │ budget        │
│ dev-sandbox  │ Dev Sandbox  │ dev        │ $1.00      │ local         │
└──────────────┴──────────────┴────────────┴────────────┴───────────────┘
```

### Show details for a single project

```bash theme={null}
voicegw project tonys-pizza
```

```
╭─ Project: tonys-pizza ───────────────────╮
│ Tony's Pizza                              │
│ Pizza ordering voice agent                │
│                                           │
│ Tags: production                          │
│ Default Stack: premium                    │
│ Daily Budget: $10.00                      │
╰───────────────────────────────────────────╯

Today: $2.4500 (120 requests)
```

### List projects with a custom config

```bash theme={null}
voicegw projects -c /etc/voicegateway/voicegw.yaml
```

## Exit Codes

| Code | Meaning                                                                  |
| ---- | ------------------------------------------------------------------------ |
| `0`  | Success (including when no projects are configured -- prints a warning). |
| `1`  | Config failed to load, or the specified project ID was not found.        |

## Related Commands

* [`voicegw costs`](/cli/costs) -- view cost breakdown for a project
* [`voicegw logs`](/cli/logs) -- view request logs filtered by project
* [`voicegw status`](/cli/status) -- see which providers each project uses