# faros app

Manage App Studio projects: list, create, status, sync, promote, publish

Source: https://faros.sh/docs/reference/cli/commands/app/

<!-- Generated by scripts/sync-cli-docs.py from faroshq/faros docs/cli. Do not edit by hand; run `make sync-cli-docs`. -->

## Synopsis

Manage App Studio projects through the App Studio REST API, as you.

```bash
faros app create shop --template application --display-name Shop --wait
faros app status shop
faros app sync shop
faros app promote shop --hostname-prefix shop
faros app publish shop --mode public
```

Develop with 'faros sandbox' against \<project>-dev and record commits with
'faros commit \<repository ref>' (the ref is shown by 'faros app status').

## Options

```text
  -h, --help               help for app
      --org string         Organization display name or UUID (default: the org that owns the kubeconfig's workspace)
      --workspace string   Workspace display name or UUID (default: the workspace the kubeconfig points at)
```

## Inherited options

```text
      --insecure-skip-tls-verify   Skip TLS certificate verification when talking to the hub
      --kubeconfig string          Path to the kubeconfig file (default: $KUBECONFIG, then ~/.kube/config)
```

## See also

- [faros](https://faros.sh/docs/reference/cli/commands/) — faros: an open-source control plane for platform teams
- [faros app create](https://faros.sh/docs/reference/cli/commands/app-create/) — Create a project (repository, scaffold commit and dev instance)
- [faros app list](https://faros.sh/docs/reference/cli/commands/app-list/) — List App Studio projects
- [faros app promote](https://faros.sh/docs/reference/cli/commands/app-promote/) — Promote the latest built commit (or --commit) to production
- [faros app publish](https://faros.sh/docs/reference/cli/commands/app-publish/) — Set production visibility: public, restricted or private
- [faros app status](https://faros.sh/docs/reference/cli/commands/app-status/) — Show a project's repository, commits, promotion and publishing state
- [faros app sync](https://faros.sh/docs/reference/cli/commands/app-sync/) — Load the repository into the project workspace and sync it to \<name>-dev