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). |
package.json (JS/TS) or pyproject.toml (Python) must be present next to the entrypoint.
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). |
For private repositories, provide --github-token or set the GITHUB_TOKEN environment variable.
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. |
Log lines longer than 64 KiB are truncated. Emit bulky payloads to external storage and log references.
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). |
Press Ctrl+C to cancel an in-flight invocation. The associated browser sessions are cleaned up automatically.
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. |
Log lines longer than 64 KiB are truncated.
