> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-config-registry-docs-ga.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 github`

Deploy directly from a GitHub repository without cloning or pushing locally.

| Flag | Description |
| - | - |
| `--url <url>` | GitHub repository URL (e.g. `https://github.com/org/repo`). |
| `--ref <ref>` | Git ref to deploy (branch, tag, or commit SHA). |
| `--entrypoint <path>` | Entrypoint within the repo (e.g. `src/index.ts`). |
| `--path <subdir>` | Subdirectory within the repo (e.g. `apps/api`). |
| `--github-token <token>` | GitHub token for private repositories (PAT or installation access token). |
| `--region <region>` | Deployment region (currently only `aws.us-east-1a`). |

<Info>For private repositories, provide `--github-token` or set the `GITHUB_TOKEN` environment variable.</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 deploy get <deployment_id>`

Get details for a deployment.

| Flag | Description |
| - | - |
| `--output json`, `-o json` | Output raw JSON object. |

## `kernel deploy delete <deployment_id>`

Delete a deployment.

| Flag | Description |
| - | - |
| `--yes`, `-y` | Skip confirmation prompt. |

## `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). |
| `--payload-file <path>`, `-f` | Read the JSON payload from a file (use `-` for stdin). |
| `--sync`, `-s` | Wait for completion (timeout after 60 s). |
| `--async-timeout <seconds>` | Timeout for async invocations (min 10, max 3600). Only applies in async mode. |
| `--since <time>` | Show invocation events since the given time when following async execution. |
| `--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 invoke get <invocation_id>`

Get an invocation.

| Flag | Description |
| - | - |
| `--output json`, `-o json` | Output raw JSON object. |

## `kernel invoke history`

Show invocation history.

| Flag | Description |
| - | - |
| `--app <name>`, `-a` | Filter by app name. |
| `--action <name>` | Filter by action name. |
| `--status <status>` | Filter by status: `queued`, `running`, `succeeded`, `failed`. |
| `--deployment-id <id>` | Filter by deployment ID. |
| `--version <version>` | Filter by invocation version. |
| `--since <time>` | Show invocations started since the given time. |
| `--limit <n>` | Max invocations to return (default: 100). |
| `--offset <n>` | Number of results to skip. |
| `--output json`, `-o json` | Output raw JSON array. |

## `kernel invoke update <invocation_id>`

Update an invocation's status or output.

| Flag | Description |
| - | - |
| `--status <status>` | New status: `succeeded` or `failed`. |
| `--output <json>` | Updated invocation output, as a JSON string. |

## `kernel invoke browsers <invocation_id>`

List browser sessions for an invocation.

| Flag | Description |
| - | - |
| `--output json`, `-o json` | Output raw JSON array. |

## `kernel invoke delete-browsers <invocation_id>`

Delete browser sessions for an invocation.

## `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 app delete <app_name>`

Delete an app and all its deployments.

| Flag | Description |
| - | - |
| `--version <version>` | Only delete deployments for this version (default: all versions). |
| `--yes`, `-y` | Skip confirmation prompt. |

## `kernel logs <app_name>`

Tail app logs.

| Flag | Description |
| - | - |
| `--version <version>` | Select an app version (default: latest). |
| `--invocation <id>`, `-i` | Show logs for a specific invocation/run. Accepts a full ID or unambiguous prefix; respects `--follow` if still running. |
| `--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>