twc-rs apps
Manage cloud apps
| Subcommand | Description |
|---|---|
list | List all cloud apps |
info | Show detailed info for a single app |
delete | Delete an app |
list-presets | List available app presets (tariffs) |
list-vcs-providers | List configured VCS providers |
list-repositories | List repositories of a VCS provider |
create | Create a new app from a connected VCS repository |
logs | Show runtime logs of an app |
list-deploys | List deploys of an app, newest first |
deploy-logs | Show build/deploy logs of a deploy (the latest one by default) |
twc-rs apps list
List all cloud apps
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps info
Show detailed info for a single app
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps delete
Delete an app
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps list-presets
List available app presets (tariffs)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps list-vcs-providers
List configured VCS providers
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps list-repositories
List repositories of a VCS provider
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--provider-id | VCS provider ID | yes | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps create
Create a new app from a connected VCS repository
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
--name | App name | yes | ||
--comment | Optional comment | |||
--provider-id | VCS provider ID (UUID) | yes | ||
--repository-id | Repository ID (UUID) | yes | ||
--preset-id | Preset (tariff) ID | yes | ||
--type | App type: backend or frontend | yes | ||
--framework | Framework (e.g. docker, react, next.js, django) | yes | ||
--branch | Repository branch to build from | main | ||
--commit-sha | Specific commit SHA (defaults to latest on the branch) | |||
--build-cmd | Build command | |||
--run-cmd | Run command (required for backend apps) | |||
--index-dir | Index directory starting with ‘/’ (required for frontend apps) | |||
--auto-deploy | Enable automatic deploy on push | false | ||
--project-id | Optional project ID to place the app in | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps logs
Show runtime logs of an app
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
--tail | Show only the last N lines (applied after date filters) | |||
--since | Show only lines logged at or after this moment; accepts YYYY-MM-DD (local midnight) or an RFC 3339 timestamp | |||
--today | Show only lines logged today (local time) | false | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps list-deploys
List deploys of an app, newest first
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |
twc-rs apps deploy-logs
Show build/deploy logs of a deploy (the latest one by default)
| Argument | Description | Required | Env | Default |
|---|---|---|---|---|
<APP> | App name or numeric ID | |||
--id | App ID (legacy alias of the positional selector) | |||
--deploy-id | Deploy ID (UUID); defaults to the most recent deploy | |||
--debug | Include debug output | false | ||
-f, --format | Output format: table (default), json, yaml, or quiet | TWC_OUTPUT | table | |
-t, --token | API token override (overrides config file and TWC_TOKEN env) | TWC_TOKEN | ||
--profile | Use a named profile’s token from the config file | TWC_PROFILE |