From d8b99c31c9e257c153482189578a14200e930d3e Mon Sep 17 00:00:00 2001
From: Andrey Avtomonov <andreybavt@gmail.com>
Date: Mon, 18 May 2026 19:21:27 +0200
Subject: [PATCH] fix(docs): restore quickstart CI snippets

---
 .../docs/getting-started/quickstart.mdx       | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/docs-site/content/docs/getting-started/quickstart.mdx b/docs-site/content/docs/getting-started/quickstart.mdx
index 22807aa7..23c77827 100644
--- a/docs-site/content/docs/getting-started/quickstart.mdx
+++ b/docs-site/content/docs/getting-started/quickstart.mdx
@@ -78,6 +78,25 @@ The wizard walks you through everything KTX needs in one pass:
 7. **Agent integration** - installs project-local rules for Claude Code,
    Codex, Cursor, OpenCode, or universal `.agents`.
 
+If you choose local `sentence-transformers` embeddings, KTX uses the managed
+Python runtime. To prepare it before setup, run:
+
+```bash
+ktx dev runtime install --feature local-embeddings --yes
+ktx dev runtime start --feature local-embeddings
+```
+
+During the database step, setup tests the saved connection and builds initial
+schema context:
+
+```text
+Testing warehouse
+  Connection test passed
+
+Building schema context for warehouse
+  Running fast database ingest
+```
+
 If setup exits early, rerun `ktx setup` in the same directory. KTX keeps
 progress under `.ktx/setup/` and resumes from the remaining work.
 
@@ -107,6 +126,18 @@ Agent integration ready: yes (codex:project)
 
 For a structured check inside scripts, use `ktx status --json`.
 
+When setup builds deep context, its final context check looks like:
+
+```text
+KTX context is ready for agents.
+
+Databases:
+  warehouse: deep context complete
+
+Context sources:
+  dbt_main: memory update complete
+```
+
 ## Connect a coding agent
 
 The setup wizard installs project-local agent rules in the last step. To