Fresh 🌱

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

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.

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.

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.