> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-docker-sandboxes-integration.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Apps

## `kernel deploy <file>`

Deploy an app to Kernel from the current directory. The entrypoint file and dependency manifest must live in the project root.

| Flag                       | Description                                                        |
| -------------------------- | ------------------------------------------------------------------ |
| `--version <version>`      | Use a specific version label (default: latest).                    |
| `--force`                  | Overwrite an existing version with the same label.                 |
| `--env <KEY=VALUE>`, `-e`  | Set environment variables (repeatable).                            |
| `--env-file <file>`        | Load environment variables from a file (repeatable).               |
| `--output json`, `-o json` | Output JSONL (one JSON object per line for each deployment event). |

<Info>`package.json` (JS/TS) or `pyproject.toml` (Python) must be present next to the entrypoint.</Info>

## `kernel deploy logs <deployment_id>`

Stream build and runtime logs for a deployment.

| Flag                       | Description                                                                                                |
| -------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `--follow`, `-f`           | Continue streaming logs in real time.                                                                      |
| `--since <duration>`, `-s` | Fetch logs starting from a relative duration (e.g. `5m`, `1h`, `1h30m`) or timestamp (`2006-01-02T15:04`). |
| `--with-timestamps`, `-t`  | Prefix each line with an RFC3339 timestamp.                                                                |

<Info>Log lines longer than 64 KiB are truncated. Emit bulky payloads to external storage and log references.</Info>

## `kernel deploy history [app_name]`

Show deployment history for all apps or a specific app.

| Flag                       | Description                                                        |
| -------------------------- | ------------------------------------------------------------------ |
| `--limit <n>`              | Maximum number of deployments to return (default: 100, `0` = all). |
| `--output json`, `-o json` | Output raw JSON array.                                             |

## `kernel invoke <app> <action>`

Invoke an app action. By default the CLI returns immediately after the invocation is queued.

| Flag                        | Description                                                        |
| --------------------------- | ------------------------------------------------------------------ |
| `--version <version>`, `-v` | Target a specific app version (default: latest).                   |
| `--payload <json>`, `-p`    | Provide a JSON payload (stringified, max 64 KB).                   |
| `--sync`, `-s`              | Wait for completion (timeout after 60 s).                          |
| `--output json`, `-o json`  | Output JSONL (one JSON object per line for each invocation event). |

<Info>Press `Ctrl+C` to cancel an in-flight invocation. The associated browser sessions are cleaned up automatically.</Info>

## `kernel app list`

List deployed app versions.

| Flag                       | Description              |
| -------------------------- | ------------------------ |
| `--name <app_name>`        | Filter by app name.      |
| `--version <version>`      | Filter by version label. |
| `--output json`, `-o json` | Output raw JSON array.   |

## `kernel app history <app_name>`

Show deployment history for a specific app.

| Flag                       | Description                                                        |
| -------------------------- | ------------------------------------------------------------------ |
| `--limit <n>`              | Maximum number of deployments to return (default: 100, `0` = all). |
| `--output json`, `-o json` | Output raw JSON array.                                             |

## `kernel logs <app_name>`

Tail app logs.

| Flag                       | Description                                                                     |
| -------------------------- | ------------------------------------------------------------------------------- |
| `--version <version>`      | Select an app version (default: latest).                                        |
| `--follow`, `-f`           | Stream logs continuously.                                                       |
| `--since <duration>`, `-s` | Fetch logs from a duration or timestamp (same formats as `kernel deploy logs`). |
| `--with-timestamps`        | Include timestamps in each line.                                                |

<Info>Log lines longer than 64 KiB are truncated.</Info>