Run kordrun with no arguments to open the live dashboard. Otherwise, use one of the commands below.

Commands

Run & supervise

Command	Description
`kordrun start`	Start every app in the Kordfile, in dependency order.
`kordrun stop`	Stop all running apps.
`kordrun restart [app]`	Restart everything, or a single app + its dependencies.
`kordrun status`	Print each app's status, port, and URL.

Logs & files

Command	Description
`kordrun logs [app] [-f]`	Show logs (optionally follow with `-f`).
`kordrun open [app]`	Open an app's URL in your browser.
`kordrun clean`	Stop all apps and clear kordrun's local state.

Licensing & setup

Command	Description
`kordrun activate <key>`	Save a license key and register this machine.
`kordrun license-id`	Print this machine's id (for machine-bound licenses).
`kordrun install-extension`	Install the Kordfile syntax extension for VS Code.
`kordrun feedback`	Share a rating + comment (shown on the site once approved).
`kordrun hosts [--clear]`	Show or remove the `/etc/hosts` entries kordrun manages.

Maintenance

Command	Description
`kordrun update`	Download, verify, and install the latest published version. Restart to apply.
`kordrun uninstall [-y] [--keep-config]`	Remove kordrun: the binary, `~/.kordrun`, and the `/etc/hosts` entries it manages.

kordrun update compares your installed version against the latest published build for your platform, downloads it, verifies its checksum, and swaps it in place. It never installs a binary whose checksum doesn't match. The dashboard also checks on launch: if a newer build is published it downloads and verifies it in the background, then shows ✓ update installed · restart to apply in the header — restarting picks up the new binary.

kordrun uninstall asks before removing anything (skip with -y). It deletes the binary from every install location, clears the /etc/hosts entries kordrun added, and removes ~/.kordrun (your saved license key and session). Pass --keep-config to keep ~/.kordrun for a later reinstall. Per-project .kordrun folders (runtime state inside your own projects) are left untouched.

Port conflicts

If an app's port is already in use by a process kordrun didn't start, it asks before killing it:

Some required ports are already in use:
  port 3000 (for 'web') is held by 'node' (pid 12345)
Kill them and continue? [y/N]

Answer y to free the port and start; kordrun never kills an unrelated process without your confirmation.

CLI commands