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

# rig app

> Manage apps inside a workspace

Available **local and workspace**. Reference source: CLI `0.13.0-rc.5` (`824aefd6ad16`).

Run this command in an authenticated local terminal or inside a workspace; see the availability above.

## Examples

Inspect the supported arguments before running this command. Help is offline and does not modify resources.

```bash theme={null}
rig app --help
```

## Local syntax

```text theme={null}
Usage: rigbox app [OPTIONS] <COMMAND>
```

### Arguments and flags

| Argument | Description | Details |
| - | - | - |
| `--output` | Output format \[default: human, or `rig config set output …`] | Global; Value: OUTPUT; Choices: human, json, yaml, text, table |
| `--query` | Filter output with a JMESPath expression | Global; Value: JMESPATH |
| `--cli-input-json` | Read inputs from a JSON file or '-' (stdin) | Global; Value: FILE |
| `--cli-input-yaml` | Read inputs from a YAML file or '-' (stdin) | Global; Value: FILE; Conflicts: cli\_input\_json |
| `--generate-cli-skeleton` | Print a fillable input template, then exit | Global; Default: false |
| `--no-pager` | Do not pipe help output through a pager | Global; Default: false |
| `-v, --verbose` | Verbose diagnostics on stderr: per-phase deploy tracing, job-poll status, and transport commands. Useful for debugging a slow or stuck `rig deploy` | Global; Default: false |
| `-h, --help` | Print help | |

> **Complete command help**
>
> ```text theme={null}
> Manage apps inside a workspace
>
> Usage: rigbox app [OPTIONS] <COMMAND>
>
> Commands:
>   ls             List apps in a workspace (or all your workspaces)
>   new            Create a new app in a workspace
>   logs           View app logs
>   expose-port    Detect or expose a workspace port as an app
>   start          Start an app
>   stop           Stop an app
>   restart        Restart an app
>   rm             Delete an app
>   share          Set app visibility (public, private, or emails)
>   health         Show app runtime health
>   verify-domain  Re-check DNS for an app custom domain
>   domain         Manage app custom domain
>   env            Manage app environment variables
>   param          Read and write catalog-app parameters
>   log-source     Manage app log sources
>   help           Print this message or the help of the given subcommand(s)
>
> Options:
>       --output <OUTPUT>
>           Output format [default: human, or `rig config set output …`]
>
>           [possible values: human, json, yaml, text, table]
>
>       --query <JMESPATH>
>           Filter output with a JMESPath expression
>
>       --cli-input-json <FILE>
>           Read inputs from a JSON file or '-' (stdin)
>
>       --cli-input-yaml <FILE>
>           Read inputs from a YAML file or '-' (stdin)
>
>       --generate-cli-skeleton
>           Print a fillable input template, then exit
>
>       --no-pager
>           Do not pipe help output through a pager
>
>   -v, --verbose
>           Verbose diagnostics on stderr: per-phase deploy tracing, job-poll status, and transport commands. Useful for debugging a slow or stuck `rig deploy`
>
>   -h, --help
>           Print help
> ```

## Workspace syntax

```text theme={null}
Usage: rigbox app [OPTIONS] <COMMAND>
```

### Arguments and flags

| Argument | Description | Details |
| - | - | - |
| `--output` | Output format \[default: human, or `rig config set output …`] | Global; Value: OUTPUT; Choices: human, json, yaml, text, table |
| `--query` | Filter output with a JMESPath expression | Global; Value: JMESPATH |
| `--no-pager` | Do not pipe help output through a pager | Global; Default: false |
| `-v, --verbose` | Verbose diagnostics on stderr (per-phase deploy tracing, job-poll status) | Global; Default: false |
| `-h, --help` | Print help | |

> **Complete command help**
>
> ```text theme={null}
> Manage apps in this workspace
>
> Usage: rigbox app [OPTIONS] <COMMAND>
>
> Commands:
>   ls             List apps in this workspace
>   new            Create a new app in this workspace
>   logs           View app logs
>   start          Start an app
>   stop           Stop an app
>   restart        Restart an app
>   rm             Delete an app
>   share          Set app visibility (public, private, or emails)
>   expose-port    Detect or expose a workspace port as an app
>   health         Show app runtime health
>   verify-domain  Re-check DNS for an app custom domain
>   domain         Manage app custom domain
>   env            Manage app environment variables
>   param          Read and write catalog-app parameters
>   log-source     Manage app log sources
>   help           Print this message or the help of the given subcommand(s)
>
> Options:
>       --output <OUTPUT>
>           Output format [default: human, or `rig config set output …`]
>
>           [possible values: human, json, yaml, text, table]
>
>       --query <JMESPATH>
>           Filter output with a JMESPath expression
>
>       --no-pager
>           Do not pipe help output through a pager
>
>   -v, --verbose
>           Verbose diagnostics on stderr (per-phase deploy tracing, job-poll status)
>
>   -h, --help
>           Print help
> ```

## Subcommands

* [domain](https://docs.rigbox.dev/cli-reference/commands/app/domain)
* [env](https://docs.rigbox.dev/cli-reference/commands/app/env)
* [expose-port](https://docs.rigbox.dev/cli-reference/commands/app/expose-port)
* [health](https://docs.rigbox.dev/cli-reference/commands/app/health)
* [log-source](https://docs.rigbox.dev/cli-reference/commands/app/log-source)
* [logs](https://docs.rigbox.dev/cli-reference/commands/app/logs)
* [ls](https://docs.rigbox.dev/cli-reference/commands/app/ls)
* [new](https://docs.rigbox.dev/cli-reference/commands/app/new)
* [param](https://docs.rigbox.dev/cli-reference/commands/app/param)
* [restart](https://docs.rigbox.dev/cli-reference/commands/app/restart)
* [rm](https://docs.rigbox.dev/cli-reference/commands/app/rm)
* [share](https://docs.rigbox.dev/cli-reference/commands/app/share)
* [start](https://docs.rigbox.dev/cli-reference/commands/app/start)
* [stop](https://docs.rigbox.dev/cli-reference/commands/app/stop)
* [verify-domain](https://docs.rigbox.dev/cli-reference/commands/app/verify-domain)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.