Skip to content

Overview

The default binary is kite (all-in-one); the lean editions — kitecmd (base only), kitecloud (base + Kubernetes), kiteai (base + MCP) — are subsets for space-conscious targets. Every command works in any edition that includes the modules it touches; edition-specific commands are flagged below.

Examples use kite; substitute kitecmd/kitecloud/kiteai for the lean editions.

Commands

Script execution

Available in every edition (base, cloud, ai, all).

Command Purpose
kite run Execute a Starlark script or module directory
kite exec Launch an external native process or shell script in the sandbox
kite eval Evaluate inline Starlark expressions and snippets
kite repl Start an interactive Read-Eval-Print-Loop (REPL)
kite watch Watch and re-execute script on file changes
kite test Run test functions in _test.star files
kite validate Validate script syntax without executing
kite doc Inspect runtime symbol documentation or generate agent skills
kite lsp Run the embedded Language Server Protocol server for editor intelligence
kite init Scaffold a new starkite module

Maintenance

Available in every edition.

Command Purpose
kite version Print version information
kite update Update starkite to the latest version
kite module Manage external modules

Cloud commands

Available in kite (all-in-one) and kitecloud.

Command Purpose
kite kube Kubernetes artifact generation (gen-controller-artifacts, gen-webhook-artifacts)

Global Flags

Flag Description Default
--var key=value Set a script variable
--var-file path Load variables from YAML file
--output format Output format: text, json, yaml, table text
--debug Enable debug logging false
--dry-run Preview commands without executing false
--timeout seconds Script execution timeout 300
--sandbox-profile name Sandbox profile name: a built-in rung (deny-all/sandbox-path/sandbox-exec/sandbox-net/unconfined) or a config.yaml profile. Default is deny-all. ""
--sandbox-mount spec Mount host path or tmpfs into sandbox: <source>[:<dest>[:ro\|rw]] or tmpfs:<dest> (repeatable).
--sandbox-path-read path Grant read access to host path (repeatable).
--sandbox-path-write path Grant read/write access to host path (repeatable).
--sandbox-exec-allow bins Allow execution of specific binaries, paths, or * (comma-separated or repeatable).
--sandbox-exec-deny bins Deny execution of specific binaries (comma-separated or repeatable).
--sandbox-call-allow rules Allow specific Starlark module calls (e.g. fs.read, http.client).
--sandbox-call-deny rules Deny specific Starlark module calls.
--sandbox-net-allow[=targets] Allow outbound network access to endpoint(s) or * for unrestricted host networking (repeatable, comma-separated). *
--sandbox-net-deny[=targets] Deny outbound network access to endpoint(s) or * for air-gapping (repeatable, comma-separated). *
--sandbox-net-mode mode Network confinement mode (host, loopback, none). ""
--sandbox-max-memory limit Maximum memory limit for sandboxed process (e.g. 512MB, 2GB). ""
--sandbox-driver driver Sandbox execution driver (auto/landlock/seatbelt/windows/podman/docker/nerdctl/gvisor). ""
--sandbox-image image OCI image for container sandbox drivers (podman/docker/nerdctl). ""
--sandbox-enabled=false Disable sandbox confinement and run unconfined. Default is true. true
--env, -e KEY[=VALUE] Forward host environment variable (KEY) or inject assignment (KEY=VALUE).
--env-inherit Inherit the full ambient host environment. false

Environment Variables

Variable Description
STARKITE_DEBUG Set to 1 or true to enable debug mode
STARKITE_OUTPUT Default output format
STARKITE_TIMEOUT Default timeout in seconds
STARKITE_VAR_* Variable injection (e.g., STARKITE_VAR_DB_HOST=localhost → var_str("db.host"))
STARKITE_SANDBOX_PROFILE Sandbox profile for shebang-launched scripts (same syntax as --sandbox-profile).
STARKITE_SANDBOX_DRIVER Sandbox execution driver override (auto, landlock, seatbelt, podman, docker, nerdctl, gvisor).