Skip to content
KB-1 Docs

CLI commands

Run these from the repository that owns the command. kb-1-cloud contains the Cloud apps and docs; the daemon lives in the local/ submodule and in the public kb-1-daemon repository.

Fresh cloud checkout

Section titled “Fresh cloud checkout”
Terminal window
git submodule update --init
pnpm install

Cloud dev stack

Section titled “Cloud dev stack”
Terminal window
pnpm bootstrap:worktree --force-env
pm2 start ecosystem.config.js
curl http://127.0.0.1:9988/api/health
pnpm --filter @kb-1-cloud/api seed:dev
pm2 restart kb1-cloud-dev-daemon

Seeded users:

User Email Password
Marcus [email protected] dev-password-123
Olivia [email protected] dev-password-123

Docs

Section titled “Docs”
Terminal window
pnpm docs:dev
pnpm docs:build
pnpm docs:preview
pnpm --filter @kb-1-cloud/docs build

Checks

Section titled “Checks”
Terminal window
pnpm check
pnpm check:catalog
pnpm check:catalog:test
pnpm lint:cloud

pnpm check runs catalog drift checks, Nx typecheck/test/build targets, and Cloud lint. Use it before committing docs or code changes.

Local daemon

Section titled “Local daemon”

From a daemon checkout:

Terminal window
corepack enable
pnpm install
KB1_HOME="$PWD/.kb1-quickstart" KB1_PORT=7382 pnpm dev

Useful probes:

Terminal window
curl http://127.0.0.1:7382/api/health
curl http://127.0.0.1:7382/api/vaults
curl http://127.0.0.1:7382/api/relay/status

Flush before backup:

Terminal window
curl -X POST http://127.0.0.1:7382/api/vaults/<vault-id>/ops/flush

E2E

Section titled “E2E”
Terminal window
pnpm test:e2e
pnpm --filter @kb-1-cloud/web test:e2e:gauntlet
pnpm test:e2e:lifecycle

The full e2e gate needs Docker because local Cloud Hosted tests build and run a managed daemon runtime through the local Docker provider.