---
title: "aeontel app"
description: "Manage apps"
section: "CLI"
group: "Commands"
order: 804
---

## App commands

### `aeontel app list`

List apps in a workspace

```ts
aeontel app list --workspace <id>
```

```bash
aeontel app list --workspace wsp_...
```

### `aeontel app create`

Create an app

```ts
aeontel app create <name> --workspace <id> [--handle <handle>] [--description <desc>] [--public]
```

```bash
aeontel app create "My name" --workspace wsp_...
```

### `aeontel app get`

Get app details

```ts
aeontel app get <id>
```

```bash
aeontel app get id_...
```

### `aeontel app update`

Update app

```ts
aeontel app update <id> [--name <name>] [--description <desc>] [--handle <handle>] [--public]
```

```bash
aeontel app update id_...
```

### `aeontel app delete`

Delete app

```ts
aeontel app delete <id>
```

```bash
aeontel app delete id_...
```

### `aeontel app build`

Trigger a build

```ts
aeontel app build <id>
```

```bash
aeontel app build id_...
```

### `aeontel app deploy`

Promote preview to production

```ts
aeontel app deploy <id>
```

```bash
aeontel app deploy id_...
```

### `aeontel app files`

List files in an app

```ts
aeontel app files <id> [--path <path>]
```

```bash
aeontel app files id_...
```

### `aeontel app read`

Read a file from an app

```ts
aeontel app read <id> <path>
```

```bash
aeontel app read id_... path/to/file
```

### `aeontel app restore`

Restore a soft-deleted app

```ts
aeontel app restore <id>
```

```bash
aeontel app restore id_...
```

### `aeontel app rm`

Delete a file from an app

```ts
aeontel app rm <id> <path>
```

```bash
aeontel app rm id_... path/to/file
```

### `aeontel app write`

Write a file to an app

```ts
aeontel app write <id> <path> [--file <localPath>] [--content <text>]
```

```bash
aeontel app write id_... path/to/file
```

## App version

App-version actions

### `aeontel app version file-create`

Create a file in a specific app version

```ts
aeontel app version file-create <appId> <versionId> <path> [--file <localPath>] [--content <text>]
```

```bash
aeontel app version file-create app_... versionid_... path/to/file
```

### `aeontel app version file-delete`

Delete a file from a specific app version

```ts
aeontel app version file-delete <appId> <versionId> <path>
```

```bash
aeontel app version file-delete app_... versionid_... path/to/file
```

### `aeontel app version file-update`

Update a file in a specific app version

```ts
aeontel app version file-update <appId> <versionId> <path> [--file <localPath>] [--content <text>]
```

```bash
aeontel app version file-update app_... versionid_... path/to/file
```

### `aeontel app version files`

List files in a specific app version

```ts
aeontel app version files <appId> <versionId> [--path <dir>]
```

```bash
aeontel app version files app_... versionid_...
```

## App preview

Live preview sessions

### `aeontel app preview get`

Get the current state of a preview session

```ts
aeontel app preview get <sessionId>
```

```bash
aeontel app preview get ses_...
```

### `aeontel app preview start`

Start (or wake) a live preview session

```ts
aeontel app preview start <appId> <versionId>
```

```bash
aeontel app preview start app_... versionid_...
```

### `aeontel app preview start-default`

Start (or wake) a preview session for the app's default version

```ts
aeontel app preview start-default <appId>
```

```bash
aeontel app preview start-default app_...
```

### `aeontel app preview stop`

Stop a preview session and tear down the sandbox

```ts
aeontel app preview stop <sessionId>
```

```bash
aeontel app preview stop ses_...
```

## App domain

Custom domain (one per app)

### `aeontel app domain get`

Show the app's custom domain (or 'no domain set')

```ts
aeontel app domain get <appId>
```

```bash
aeontel app domain get app_...
```

### `aeontel app domain remove`

Detach the app's custom domain

```ts
aeontel app domain remove <appId>
```

```bash
aeontel app domain remove app_...
```

### `aeontel app domain set`

Attach a custom domain. Customer must add a CNAME at their DNS provider for it to activate.

```ts
aeontel app domain set <appId> <hostname>
```

```bash
aeontel app domain set app_... <hostname>
```