docs(guide): correct install docs to the clawdie binary (drop clawdie-ai just/Ansible) #213

Merged

clawdie merged 1 commit from docs/install-correct-to-clawdie-binary into main

2026-06-26 15:05:25 +02:00

clawdie commented

2026-06-26 10:50:35 +02:00

Owner

Corrects the docs/guide/install/ section, which was clawdie-ai documentation ported into the colibri repo — it documented a just install Node/tsx 20-step orchestrator + Ansible (setup/, infra/ansible/, setup/onboarding.ts), none of which exist here. colibri is a Cargo workspace; its real installer is the clawdie binary (crates/clawdie).

Per the decision that colibri/clawdie is the installer now, these are rewritten to the actual flow (sourced from crates/clawdie/README.md + the crate), with no invented commands:

Page	Change
`install.md`	Rewritten to `clawdie discover` / `plan` / `apply --yes` — commands, FreeBSD/Linux storage strategy, dataset layout, what `apply` provisions, `--create-pool` destructive guard, dry-run safety. Adds a Scope section marking PF/jails/PostgreSQL/Forgejo/CMS provisioning as legacy clawdie-ai, not yet in the colibri installer.
`controlplane-install.md`	`just install` → `cargo build -p clawdie` + `clawdie apply --yes`.
`index.md`	"Install orchestrator / `just install`" → the `clawdie` flow.
`requirements.md`	Toolchain → Cargo/`clawdie` (dropped Node/`tsx`); install command fixed; note that the runtime-philosophy prose is still clawdie-ai, pending reconciliation.

Deliberately out of scope (flagged, not fabricated)

clawdie has 3 commands (discover/plan/apply); the legacy docs reference ~15 (setup-db, doctor, preflight, system-update, per-step jails/dns/cms…) with no colibri equivalent. Rewriting those would invent a CLI, so they're left for the broader clawdie-ai-docs reconciliation:

first-boot.md (already flagged in-repo for the ISO QML rewrite)
fresh-install-checklist.md
just install/setup/doctor mentions across the architecture pages

The new install.md Scope section tells readers those just … references are legacy, so the mental model is correct even before each page is individually fixed.

Note on the Slovenian PR (#210)

This supersedes the install translations: I'll re-translate install/ from this corrected English once it merges. The sl/install/* pages in #210 inherit the old just install framing and shouldn't merge as-is.

🤖 Generated with Claude Code

Corrects the `docs/guide/install/` section, which was **clawdie-ai documentation ported into the colibri repo** — it documented a `just install` Node/`tsx` 20-step orchestrator + Ansible (`setup/`, `infra/ansible/`, `setup/onboarding.ts`), none of which exist here. colibri is a Cargo workspace; its real installer is the **`clawdie` binary** (`crates/clawdie`). Per the decision that **colibri/clawdie is the installer now**, these are rewritten to the actual flow (sourced from `crates/clawdie/README.md` + the crate), with **no invented commands**: | Page | Change | |---|---| | `install.md` | Rewritten to `clawdie discover` / `plan` / `apply --yes` — commands, FreeBSD/Linux storage strategy, dataset layout, what `apply` provisions, `--create-pool` destructive guard, dry-run safety. Adds a **Scope** section marking PF/jails/PostgreSQL/Forgejo/CMS provisioning as legacy clawdie-ai, *not yet in the colibri installer*. | | `controlplane-install.md` | `just install` → `cargo build -p clawdie` + `clawdie apply --yes`. | | `index.md` | "Install orchestrator / `just install`" → the `clawdie` flow. | | `requirements.md` | Toolchain → Cargo/`clawdie` (dropped Node/`tsx`); install command fixed; note that the runtime-philosophy prose is still clawdie-ai, pending reconciliation. | ### Deliberately out of scope (flagged, not fabricated) `clawdie` has **3 commands** (`discover`/`plan`/`apply`); the legacy docs reference ~15 (`setup-db`, `doctor`, `preflight`, `system-update`, per-step jails/dns/cms…) with **no colibri equivalent**. Rewriting those would invent a CLI, so they're left for the broader clawdie-ai-docs reconciliation: - `first-boot.md` (already flagged in-repo for the ISO QML rewrite) - `fresh-install-checklist.md` - `just install/setup/doctor` mentions across the architecture pages The new `install.md` **Scope** section tells readers those `just …` references are legacy, so the mental model is correct even before each page is individually fixed. ### Note on the Slovenian PR (#210) This supersedes the install translations: I'll re-translate `install/` from this corrected English once it merges. The `sl/install/*` pages in #210 inherit the old `just install` framing and shouldn't merge as-is. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

clawdie added 1 commit 2026-06-26 10:50:38 +02:00

docs(guide): correct install docs to the clawdie binary (not just/clawdie-ai)

CI / rust (pull_request) Waiting to run

Details

CI / markdown (pull_request) Waiting to run

Details

CI / port (pull_request) Waiting to run

Details

CI / agent-jail-pkgs (pull_request) Waiting to run

Details

123f86196d

The install/ section was clawdie-ai docs ported into colibri: it documented a
`just install` Node/tsx 20-step orchestrator + Ansible, none of which exists
here (colibri is a Cargo workspace). colibri's real installer is the `clawdie`
binary (crates/clawdie): `discover` / `plan` / `apply --yes` → ZFS datasets +
clawdie service user + rc.d/systemd unit running colibri-daemon.

- install.md: rewritten to the clawdie flow (commands, storage strategy,
  what apply provisions, --create-pool safety) from crates/clawdie/README.md.
  Adds a Scope section marking PF/jails/PostgreSQL/CMS provisioning as legacy
  clawdie-ai (not yet in the colibri installer) — no invented commands.
- controlplane-install.md: rewritten to `cargo build -p clawdie` + apply.
- index.md: "Install orchestrator / just install" → clawdie discover/plan/apply.
- requirements.md: toolchain → Cargo/clawdie (drop Node/tsx), install command
  fixed, and a note that the runtime-philosophy prose is still clawdie-ai
  pending reconciliation.

Out of scope (flagged for follow-up): first-boot.md (ISO QML rewrite pending),
fresh-install-checklist.md, and the `just install/setup/doctor` mentions in the
architecture pages — all broader clawdie-ai legacy.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>