Skip to content

apps.mdx

Latest commit

 

History

History
76 lines (58 loc) · 3.05 KB

apps.mdx

File metadata and controls

76 lines (58 loc) · 3.05 KB
title 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).

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

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 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).

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

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.

Log lines longer than 64 KiB are truncated.