spb/khaelor Public

1<!--2KHAELOR3File: website/CONTENT_TODO.md4Description: Documentation content items to re-verify against the final CLI before/at launch.5Author: Simon-Pierre Boucher6Contact: contact@spboucher.ai7-->89# Content TODO — verify against final CLI1011The docs were written from the Phase 1 design contracts (`docs/TUI_DESIGN.md`,12`docs/TOOL_PROTOCOL.md`, `docs/PERMISSION_MODEL.md`, `CLAUDE.md`) and the13implemented `src/` where it exists. As of writing, **`src/cli/` does not exist14yet** (package.json points `bin` at `dist/cli/main.js`), and several slash15commands are registered as honest "not wired in this build" placeholders in16`src/tui/app.ts`. Re-verify the following once the CLI lands.1718## Verify against final CLI1920- [ ] **CLI flags** (`docs/getting-started.html#cli-flags`): `--model`,21      `--print`, `--debug`, `--version` are documented from README/CLAUDE.md.22      `src/cli/main.ts` does not exist yet — confirm exact flags and add any23      missing ones (e.g. `--benchmark-startup` is internal; keep it out).24- [ ] **`khaelor --version` output format** — install.sh captures and prints25      it; confirm it prints a bare version (installer displays it verbatim).26- [ ] **Slash commands not yet implemented** (placeholders in27      `src/tui/app.ts` as of 2026-08-09): `/model` (Phase 3), `/config`28      (Phase 3), `/sessions` (Phase 6), `/context` (Phase 6), `/compact`29      (Phase 6), `/processes` (Phase 5), `/permissions` (Phase 4). Docs30      describe the designed (final) behavior — confirm panels match the spec31      screenshots in `docs/commands.html` once wired.32- [ ] **Slash commands documented but not yet registered at all** in33      `src/tui/app.ts`: `/resume`, `/new`, `/rename`, `/clear`, `/status`.34      They are in the TUI_DESIGN §4.1 V1 set — confirm they ship, and confirm35      `/status` output content (docs/commands.html#cmd-status is inferred).36- [ ] **Implemented today and verified against code**: `/diff` (`d`),37      `/cost`, `/help`, `/quit` (`Ctrl+D`), `Ctrl+K` palette.38- [ ] **Config keys** (`docs/configuration.html`): verified against39      `src/config/schema.ts` (`model`, `auxModel`, `thinking`,40      `maxOutputTokens`, `permissions`; defaults claude-sonnet-4-5 /41      claude-haiku-4-5 / adaptive / 16000). NOTE: the implemented42      `permissions` schema is currently the flat `capability → action`43      shorthand only — the nested/`rules` forms documented on44      docs/permissions.html come from PERMISSION_MODEL §4.1. Confirm the45      loader accepts them before launch, or trim the example.46- [ ] **Theme key** — `/config` panel mock shows a `Theme` row47      (khaelor-dark); `theme` is not in `src/config/schema.ts` yet. Confirm48      or remove from the docs/configuration.html panel mock.49- [ ] **Session storage path** — docs say `~/.khaelor/sessions/`;50      `src/session/store.ts` should confirm the exact location.51- [ ] **Spill paths** — TOOL_PROTOCOL uses `~/.khaelor/tool-output/` but52      TUI_DESIGN §6.2 shows `~/.khaelor/tool-out/`. Docs standardized on53      `tool-output` — confirm in `src/tools/truncate.ts`.54- [ ] **Default bash timeout / cap** (120 s / 300 s), grep 100-line cap,55      read 2000-line default — confirm constants in `src/tools/*` match.56- [ ] **npm distribution**: docs and installer assume the tarball URL57      (`https://www.khaelor.sh/khaelor.tgz`). If/when `khaelor` is published58      to the npm registry, update index.html, getting-started.html, faq.html59      (`npm uninstall -g khaelor` already assumes the package name), and60      install.sh to prefer `npm install -g khaelor`.61- [ ] **Keychain API key storage** — CLAUDE.md §6 mentions optional keychain62      storage; docs currently say "environment only" (matches implemented63      loader). Update if keychain support ships.6465## Deploy-time6667- [ ] Build tarball from repo root (`npm run build && npm pack`) and drop as68      `website/artifacts/khaelor.tgz` on the serving node.69- [ ] Smoke-test the full installer path end-to-end on a clean machine once70      the tarball is real: `curl -fsSL https://www.khaelor.sh/install.sh | sh`.7172---7374*Author: Simon-Pierre Boucher · contact@spboucher.ai*75