diff --git a/packages/kilo-docs/lib/nav/automate.ts b/packages/kilo-docs/lib/nav/automate.ts index 772d63611d2..53103201a94 100644 --- a/packages/kilo-docs/lib/nav/automate.ts +++ b/packages/kilo-docs/lib/nav/automate.ts @@ -22,6 +22,10 @@ export const AutomateNav: NavSection[] = [ subLinks: [ { href: "/automate/kiloclaw/overview", children: "Overview" }, { href: "/automate/kiloclaw/dashboard", children: "Dashboard" }, + { + href: "/automate/kiloclaw/pre-installed-software", + children: "Pre-installed Software", + }, { href: "/automate/kiloclaw/control-ui", children: "Control UI" }, { href: "/automate/kiloclaw/chat-platforms", diff --git a/packages/kilo-docs/pages/automate/kiloclaw/pre-installed-software.md b/packages/kilo-docs/pages/automate/kiloclaw/pre-installed-software.md new file mode 100644 index 00000000000..736ed167e19 --- /dev/null +++ b/packages/kilo-docs/pages/automate/kiloclaw/pre-installed-software.md @@ -0,0 +1,99 @@ +--- +title: "Pre-installed Software" +description: "Default system utilities, languages, and CLI tools included in the KiloClaw Docker image" +--- + +# Pre-installed Software + +Every KiloClaw instance ships with a curated set of system utilities, language runtimes, package managers, and CLI tools. This page documents everything that comes pre-installed in the KiloClaw Docker image so you know what's available out of the box. Where a specific version is listed it reflects the pin in the Dockerfile as of March 2026. Entries marked **unpinned** install the latest available version at image build time and may differ between releases. + +## Base Image + +KiloClaw is built on **Debian Bookworm** (`debian:bookworm-slim`). Since it's Debian-based, you can use `apt` to install additional packages at any time: + +```bash +apt update && apt install -y +``` + +{% callout type="info" %} +Packages installed via `apt` do not persist across redeploys. If you need a package to survive redeploys, install it from a cron job or startup script on the persistent volume. +{% /callout %} + +## System Utilities + +The following packages are installed via `apt` on top of the base image: + +| Package | Description | +| ----------------- | ----------------------------------------- | +| `ca-certificates` | Root CA certificates for TLS verification | +| `curl` | HTTP client | +| `gnupg` | GPG encryption and signing | +| `git` | Version control | +| `unzip` | Archive extraction | +| `jq` | JSON processor | +| `ripgrep` | Fast recursive search (`rg`) | +| `rsync` | File synchronization | +| `zstd` | Zstandard compression | +| `build-essential` | GCC, make, and core build tools | +| `python3` | Python 3 interpreter (system default) | +| `ffmpeg` | Audio/video processing | +| `tmux` | Terminal multiplexer | + +## Languages & Runtimes + +| Language / Runtime | Version | Install Method | +| ------------------ | ---------------------------------- | -------------------------------- | +| Node.js | 22.13.1 | Binary tarball (primary runtime) | +| Go | 1.26.0 | Binary tarball | +| Bun | 1.2.4 | Install script | +| Python 3 | Unpinned (Debian Bookworm default) | `apt` | + +## Package Managers + +These package managers are available for installing libraries and dependencies: + +| Manager | Included Via | +| ------- | -------------------- | +| `npm` | Bundled with Node.js | +| `pnpm` | Installed via `npm` | +| `bun` | Bundled with Bun | + +## CLI Tools + +| Tool | Version / Source | +| -------------------- | --------------------------- | +| GitHub CLI (`gh`) | Unpinned (GitHub apt repo) | +| 1Password CLI (`op`) | 2.32.1 (1Password apt repo) | + +## npm Global Packages + +The following packages are installed globally via `npm`: + +| Package | Version | +| ----------------------- | -------- | +| ClawHub CLI (`clawhub`) | Unpinned | +| mcporter | 0.7.3 | +| `@steipete/summarize` | 0.11.1 | + +## Go Tools + +These tools are pre-installed via `go install` and available on `$PATH`: + +| Tool | Version | +| ------------- | ------- | +| `gog` | 0.11.0 | +| `goplaces` | 0.3.0 | +| `blogwatcher` | 0.0.2 | +| `xurl` | 1.0.3 | +| `gifgrep` | 0.2.3 | + +{% callout type="tip" %} +These tools receive updates when you **Upgrade & Redeploy** your instance from the [KiloClaw Dashboard](/docs/automate/kiloclaw/dashboard#redeploy). Check the changelog for image update announcements. +{% /callout %} + +## Related + +- [KiloClaw Overview](/docs/automate/kiloclaw/overview) +- [Dashboard Reference](/docs/automate/kiloclaw/dashboard) +- [Machine Specs](/docs/automate/kiloclaw/dashboard#machine-specs) +- [Troubleshooting](/docs/automate/kiloclaw/troubleshooting)