# Khal OS

## Docs

- [Closed-loop intelligence](https://docs.khal.ai/brain/auto-kb.md): brain auto-kb — autonomous Generate → Reflect → Curate → Evolve loop. The feature that makes Brain different from every other vector store.
- [Configuration](https://docs.khal.ai/brain/configuration.md): brain.json reference, environment variables, and embedding model options
- [Knowledge graph operations](https://docs.khal.ai/brain/knowledge-graph.md): Link, graph, dedup, health, score, forget — the graph operations that make Brain a knowledge graph, not just a vector store.
- [Brain Overview](https://docs.khal.ai/brain/overview.md): A self-improving knowledge graph for AI agents. Generate → Reflect → Curate → Evolve.
- [Quickstart](https://docs.khal.ai/brain/quickstart.md): Install Brain, create your first vault, and run your first search in under 5 minutes
- [Retrieval](https://docs.khal.ai/brain/search.md): The full retrieval pipeline: BM25 + vector + trigram in parallel, fused with RRF, uplifted by the link graph, gated by confidence.
- [FDE CLI quickstart](https://docs.khal.ai/dev/fde-cli-quickstart.md): Install the public khal CLI from npmjs, log in with WorkOS, scaffold a new app, validate it locally, and dry-run install before touching a target.
- [FDE environment ladder](https://docs.khal.ai/dev/fde-environment-ladder.md): How Full-stack Developer Experience engineers move a KhalOS app from local proof to shared dev, customer dev, and production.
- [Source control for KHAL teams](https://docs.khal.ai/dev/gitea-source-control.md): How public GitHub docs and private KHAL engineering repositories fit together without widening the docs deployment security boundary.
- [Local dev and testing](https://docs.khal.ai/dev/local-dev-and-testing.md): The full local development loop for a Khal pack: build, watch, typecheck, test, debug.
- [Clone the workspace](https://docs.khal.ai/getting-started/clone-workspace.md): How to fetch KHAL source from the right remote: private app/platform repos in Gitea, public docs/app-kit/desktop exceptions on GitHub.
- [Install dependencies](https://docs.khal.ai/getting-started/install-dependencies.md): Which package manager to use where — pnpm for the SDK workspace, bun for pack-* repos — and the commands that get everything compiling.
- [Your first pack](https://docs.khal.ai/getting-started/your-first-pack.md): Scaffold a pack with `khal new`, edit a React component, and see it running inside the KhalOS shell.
- [Khal OS — the browser-based OS for agents and the humans who ship with them](https://docs.khal.ai/index.md): The FDE manual for building, shipping, and deploying packs on khal-os.
- [Anatomy of a pack](https://docs.khal.ai/packs/anatomy-of-a-pack.md): A directory-level tour of every file inside a pack — manifest, frontend package, backend service, Helm chart, CI workflows — and the runtime role each one plays.
- [khal-app.json](https://docs.khal.ai/packs/khal-app-json.md): The manifest file at the root of every pack — what the platform reads to install, run, and route your pack. Required fields, optional fields, and two worked examples.
- [Frontend-only pack](https://docs.khal.ai/patterns/frontend-only-pack.md): The canonical pattern when your pack does not need a backend service. pack-settings as the reference.
- [Full-stack pack](https://docs.khal.ai/patterns/full-stack-pack.md): A pack with a backend service. pack-terminal (PTY over NATS) as the reference.
- [Example packs](https://docs.khal.ai/reference/example-packs.md): Reference packs with real manifests — what to read when you need a working template for a common shape.
- [khal-app.json schema](https://docs.khal.ai/reference/khal-app-json-schema.md): The complete manifest reference, derived from @khal-os/types.
- [Customer install](https://docs.khal.ai/release/customer-install.md): How a customer admin installs a git-native Khal-OS app — the thin version an FDE needs to understand.
- [Publish your pack](https://docs.khal.ai/release/publish-your-pack.md): Push → CI → reviewed git source. The FDE release flow before customer install.
- [SDK hooks reference](https://docs.khal.ai/sdk/hooks-reference.md): React hooks from @khal-os/sdk/app for talking to the platform from your pack.
- [useKhalAuth](https://docs.khal.ai/sdk/useKhalAuth.md): Read the authenticated user, org, role, and permissions from your pack.
- [useNats](https://docs.khal.ai/sdk/useNats.md): Publish, subscribe, and request/reply over NATS from your pack's frontend.
- [useService](https://docs.khal.ai/sdk/useService.md): Call your pack's backend service with a transport-agnostic client.
- [Backend services overview](https://docs.khal.ai/services/backend-overview.md): Ship a Bun service alongside your pack's frontend. NATS in, anything out.
- [Environment + config](https://docs.khal.ai/services/environment-config.md): Declare env vars in khal-app.json. The platform injects values at runtime.
- [What is Khal OS?](https://docs.khal.ai/what-is-khal-os.md): A browser-based OS where packs run side-by-side for humans and agents — and how you build, ship, and distribute them.

## OpenAPI Specs

- [openapi](https://docs.khal.ai/api-reference/openapi.json)