Skip to main content
Install tools in this order. The KHAL and KHAW commands are the product surface; private repo checkouts are source access details from onboarding.

1. Base tools

git --version
node --version
npm --version
bun --version
python3 --version
Simulated output:
git version 2.x.x
v22.x.x
10.x.x
1.x.x
Python 3.11.x
If Bun is missing:
curl -fsSL https://bun.sh/install | bash

2. Gitea CLI (tea)

tea login list
tea whoami
If tea whoami fails, email/Gitea access probably is not finished. Do not invent credentials; ask your onboarding owner.

3. KHAW CLI

Use the private KHAW repo URL from your onboarding note:
git clone --branch dev <private-khaw-gitea-repo-url> ~/.khaw-src
mkdir -p ~/.local/bin
ln -sf ~/.khaw-src/bin/khaw ~/.local/bin/khaw
export PATH="$HOME/.local/bin:$PATH"
khaw --version
khaw status
khaw doctor
Successful shape:
KHAW version: 1.0.x
KHAW target: <commit-or-branch>
KHAW working tree: clean
Doctor: OK for native harness

4. KHAL CLI (khal)

AppKit distribution is KHAL-owned. Do not install the FDE CLI through npm.
curl -fsSL https://install.khal.ai/app-kit -o khal-app-kit-installer.sh
sh khal-app-kit-installer.sh
khal --version
khal --help
Current command families include:
new, start, build, deploy, install, list, logs, link, pull,
login, git, promote, auth, whoami, logout, config, target,
context, doctor, dev, infra, telemetry, update

5. First health snapshot

khaw --version
khaw doctor
khal --version
khal context --target dev --text
khal doctor --target dev
Keep the output. It tells your agent whether you are blocked by local setup, identity, source control, target reachability, or permissions.
TASK: I am reading `fde-start-here/install-toolchain.mdx` (Install your FDE toolchain). Use this page as the contract, then verify current CLI/output before you guide me.
CONTEXT: I may be a new KHAL FDE. Prefer read-only checks and dry-runs first. Do not mutate customer, HML, production, credentials, SSH, Gitea, or model-provider state without an explicit GO.
SAFE FIRST COMMANDS: Check versions, identity, target, git source/ref, KHAW doctor/status, KHAL context, and dry-run output. Redact secrets and private URLs.
EVIDENCE: Return command, exit status, sanitized output, what it proves, and the next safe action.