Klimkit is intended for trusted personal machines and private tailnets.
The default Codex harness is tuned for a dedicated VM or external sandbox where yolo-mode automation is acceptable. Do not use that profile on a machine with broad cloud credentials, production write access, or unrelated private files.
- Switchboard can run without an auth token only on loopback. Non-loopback hosts require
switchboard.server.auth_token. - Tokenless loopback access also rejects non-loopback
Hostheaders to reduce DNS-rebinding exposure. If Switchboard is exposed through a proxy, configure a token and HTTPS cookie behavior explicitly. - Tailscale Serve is the intended remote exposure layer for Switchboard and code-server.
- code-server is configured with loopback binding and
auth: none;kk applyconfigures Tailscale Serve so each client VM exposes its own code-server only inside the private tailnet. - With
[code_server] managed_profile = true, Klimkit syncs the repo's code-serverUserprofile and extension list to every VM. The managed profile disables workspace trust and enables automatic tasks for a trusted operator box; do not use it for untrusted workspaces. - Switchboard agent helper binds to
127.0.0.1by default. Only set anotherswitchboard.agent.helper_hostfor a trusted proxy path. - Switchboard-launched Codex terminals are trusted-local automation and may use sandbox/approval bypass flags when configured.
- Switchboard proof reports are served only from configured repo roots under
.klimkit/reports/or valid.klimkit/<operator>/reports/directories. Reserved artifact/runtime names are not treated as report owners, and symlinked.klimkitroots, operator directories, or report directories that escape the repo evidence tree are rejected. - The projected Codex config may use
sandbox_mode = "danger-full-access"andapproval_policy = "never"by default. Keep the VM least-privileged and purpose-built. - The single local TOML can contain Switchboard and Telegram tokens.
.klimkit/local/,.klimkit/state/,.klimkit/backups/, and.klimkit/logs/are ignored by default; keep only sanitized task/proof/memory/log artifacts tracked. kk previewshows external installer actions such as the code-server upstream network installer. Review the plan beforekk apply, or disable the installer withcode_server.install_if_missing = false.- Tailscale may require a one-time
sudo tailscale set --operator=$USERbefore a non-rootkk applycan update Serve routes.
Report vulnerabilities privately through the repository owner until a public advisory channel is configured.