From 130bd0660b81102ad52a55b0f4811be13430e642 Mon Sep 17 00:00:00 2001 From: Ray Date: Wed, 15 Jul 2026 16:09:13 +0800 Subject: [PATCH 1/3] update readme --- README.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 0fecbe11..922a08f2 100644 --- a/README.md +++ b/README.md @@ -187,6 +187,16 @@ A "generator" reads from the compiled wiki and produces something usable: an ans | openkb skill new <skill-name> "<intent>" | Distill a redistributable agent skill from your wiki (see [Skill Factory](#skill-factory) below) | [skills](examples/skills/) | | openkb deck new <name> "<intent>" | Generate a single-file HTML slide deck (`--skill` picks a theme, `--critique` runs a quality pass) | [slides](examples/slides/) | +### 💬 Query & Chat — *ask the wiki* + +The core loop: `openkb query "..."` returns a grounded, cited answer from your wiki, and `openkb chat` opens an interactive multi-turn session over it (`--resume`, `--list`, `--delete` to manage sessions). Both run on OpenKB's reasoning-based retrieval, with no vector DB. → Walked through with real saved output in **[`examples/commands/`](examples/commands/)** (query) and **[`examples/chat/`](examples/chat/)** (chat). + + + +### 🛠 Skill Factory — *drop in a book; out comes a digital expert.* + +`openkb skill new` distills a portable [agent skill](https://docs.claude.com/en/docs/build-with-claude/skills) from your wiki that Claude Code, Codex, and Gemini can install and load natively. Drop in a book's worth of papers; out comes a specialist other agents can call on. → A real generated skill, plus install / share / `eval` / rollback, is walked through in **[`examples/skills/`](examples/skills/)**. +
More skill commands:
@@ -199,12 +209,6 @@ A "generator" reads from the compiled wiki and produces something usable: an ans
- - -### 🛠 Skill Factory — *drop in a book; out comes a digital expert.* - -The flagship generator: `openkb skill new` distills a portable [agent skill](https://docs.claude.com/en/docs/build-with-claude/skills) from your wiki that Claude Code, Codex, and Gemini can install and load natively. Drop in a book's worth of papers; out comes a specialist other agents can call on. → A real generated skill, plus install / share / `eval` / rollback, is walked through in **[`examples/skills/`](examples/skills/)**. - # 🔧 Configuration ### Settings From fbc9ef07a42be1114a7fd31c5cd31479317688be Mon Sep 17 00:00:00 2001 From: Ray Date: Wed, 15 Jul 2026 17:02:42 +0800 Subject: [PATCH 2/3] add chat slash commands to readme --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/README.md b/README.md index 922a08f2..09fe83ad 100644 --- a/README.md +++ b/README.md @@ -191,6 +191,28 @@ A "generator" reads from the compiled wiki and produces something usable: an ans The core loop: `openkb query "..."` returns a grounded, cited answer from your wiki, and `openkb chat` opens an interactive multi-turn session over it (`--resume`, `--list`, `--delete` to manage sessions). Both run on OpenKB's reasoning-based retrieval, with no vector DB. → Walked through with real saved output in **[`examples/commands/`](examples/commands/)** (query) and **[`examples/chat/`](examples/chat/)** (chat). +Inside `openkb chat`, type `/` for slash commands (Tab to complete): + +
+Slash commands: +
+ +| Command | Does | +|---|---| +| `/help` | List available commands | +| `/status` | Show knowledge base status | +| `/list` | List all documents | +| `/add ` | Add a document or directory without leaving the chat | +| `/save [name]` | Export the transcript to `wiki/explorations/` | +| `/skill new ""` | Compile a skill from this chat | +| `/deck new ""` | Generate a slide deck (`--skill` picks a theme, `--critique` runs a quality pass) | +| `/critique ` | Run a quality critique pass on a generated deck | +| `/lint` | Run knowledge base lint | +| `/clear` | Start a fresh session (the current one stays on disk) | +| `/exit` | Exit (`/quit` or Ctrl-D also work) | + +
+ ### 🛠 Skill Factory — *drop in a book; out comes a digital expert.* From a69aeb663dbaf2566bc4ad93f9c28aa413020ef8 Mon Sep 17 00:00:00 2001 From: Ray Date: Wed, 15 Jul 2026 19:16:31 +0800 Subject: [PATCH 3/3] update readme --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 09fe83ad..68fe6c17 100644 --- a/README.md +++ b/README.md @@ -189,7 +189,7 @@ A "generator" reads from the compiled wiki and produces something usable: an ans ### 💬 Query & Chat — *ask the wiki* -The core loop: `openkb query "..."` returns a grounded, cited answer from your wiki, and `openkb chat` opens an interactive multi-turn session over it (`--resume`, `--list`, `--delete` to manage sessions). Both run on OpenKB's reasoning-based retrieval, with no vector DB. → Walked through with real saved output in **[`examples/commands/`](examples/commands/)** (query) and **[`examples/chat/`](examples/chat/)** (chat). +`openkb query "..."` answers a single question with a grounded, cited answer from your wiki. `openkb chat` is interactive, an ongoing multi-turn session over the same wiki (`--resume`, `--list`, `--delete` to manage sessions). → Walked through with real saved output in **[`examples/commands/`](examples/commands/)** (query) and **[`examples/chat/`](examples/chat/)** (chat). Inside `openkb chat`, type `/` for slash commands (Tab to complete):