Skip to content

Filesystem and environment

Item Location Purpose
Config $XDG_CONFIG_HOME/kact/kact.toml or ~/.config/kact/kact.toml User settings.
Log Config path with .log extension Background start output.
Socket $XDG_RUNTIME_DIR/kact.sock, otherwise the system temporary directory Local daemon control.
macOS LaunchAgent ~/Library/LaunchAgents/io.kact.agent.plist Optional login startup.

Use kact config path to see the chosen config path. The socket directory must be owned by the current user and have mode 0700.

kact start writes daemon logs beside the active configuration. When using a custom instance, pass both --config and --socket to kact start, then pass the same --socket to every action command:

Terminal window
kact --config "$HOME/.config/kact/work.toml" --socket /tmp/kact-work.sock start
kact --socket /tmp/kact-work.sock activate grid

The client’s --config option does not change an already-running daemon. Restart it with the desired startup options instead.

Variable Use
XDG_CONFIG_HOME Chooses the config base when it is an absolute path.
XDG_RUNTIME_DIR Chooses the socket directory.
WAYLAND_DISPLAY Causes the Linux backend to reject the session because native Wayland injection is unsupported.
HOME Fallback config location and macOS LaunchAgent location.
DISPLAY Used by X11 through the native Xlib connection.