Command line

A reference for the command-line tools you'll use operating a Kiki device. These run on the device itself (over SSH for headless machines).

kpkg — apps

kpkg manages apps and other artifacts (kpkgd is the daemon behind it).

kpkg install io.kiki.my-app        # install an app by id
kpkg list                          # list installed apps
kpkg remove io.kiki.my-app         # uninstall
kpkg pack                          # build + package an artifact into a .kiki
kpkg publish ./my-app-1.0.0.kiki   # publish to the store

Command	What it does
install	Pull, verify, and install an artifact by id.
list	Show installed artifacts.
remove	Uninstall an artifact.
pack	Build and package an artifact (see Publishing).
publish	Upload a bundle to the store.

bootc — OS updates

The OS updates with bootc, not a package manager. Updates are atomic with automatic rollback.

sudo bootc switch ghcr.io/kiki-os/kiki-os-desktop:latest   # stage a new image
sudo bootc status                                           # show booted + staged
sudo systemctl reboot                                       # apply on next boot
sudo bootc rollback                                         # return to the previous image

Command	What it does
switch <ref>	Stage a new OS image to boot into.
status	Show current and staged images.
rollback	Return to the previously booted image.

When a device is in the cloud, updates can be delivered over the air to a whole fleet instead of run by hand.

agentd — the agent service

Normally started by the system, but useful directly during development:

agentd --config /etc/kiki/agentd.toml   # config path (this is the default)
agentd --no-fleet                         # don't connect to the cloud
agentd --no-wm                            # run headless, no desktop

sudo systemctl restart agentd             # restart after editing config
sudo systemctl status agentd

See Configuration for what's in agentd.toml.

Building images

If you're building the OS itself, see Custom images for the make targets.