Ae Kb
AE knowledge base CLI manual for creating, importing read-only compiled snapshots, querying, LLM-powered ask, listing accessible knowledge bases and their sources, deterministic index/grep/read retrieval, checking status, ZIP source upload and directory management, raw child-file reading, revision-checked child updates and deletion, compiling, schema generation, URL sources, source deletion, file/ZIP source draft replacement and restoration, and knowledge base deletion. Use when the user asks to manage AE (Agentic Engine) knowledge bases, import a compiled Markdown ZIP snapshot, upload documents or URLs to a knowledge base, query knowledge, ask knowledge bases with an LLM, list accessible knowledge bases or source metadata, inspect knowledge base indexes, search knowledge base pages, read a specific knowledge base page, check knowledge base status, generate schemas, compile knowledge, remove sources, or delete a knowledge base. To choose which knowledge base is worth searching, use the ae-kb-discovery skill first; this skill runs the retrieval once a target is chosen. Must use ae-cli kb commands and must not guess knowledge base names, scopes, page paths, source IDs, source display names, JSON payload shapes, or URL formats.
- Skill ID
- thinkingaiagenticengine/ae-cli/ae-kb
- Publisher
- thinkingaiagenticengine
- Repository
- ae-cli
- Installs
- 0
- Files
- 5
- Synced
- Sep 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
thinkingaiagenticengine/ae-cli/ae-kbInstalls these files- SKILL.md
- references/analysis-workflow.md
- references/query-workflow.md
- references/source-mutations.md
- references/versions.md
What this skill tells the agent
ae-kb
AE CLI (ae-cli) knowledge base commands are invoked through:
ae-cli kb +<command> [options]
ae-cli kb source <replace|restore|preview|commit|cancel|check-updates> [options]Global Rules
- Use this skill for AE knowledge base tasks: create, import a compiled snapshot, query, ask with LLM, list accessible knowledge bases and their sources, inspect indexes, grep pages, read pages, check status, upload sources, add URL sources, generate schema, compile, remove source files, and delete knowledge bases.
- Searching a knowledge base for an answer is the most common task. If that is what you are doing, go straight to [Explore Knowledge Base Pages](#explore-knowledge-base-pages) and read [`references/query-workflow.md`](references/query-workflow.md) first — it is the retrieval procedure. The other commands below are for managing knowledge bases, not answering from them.
- When retrieved pages will guide project-scoped business data analysis, read and follow [`references/analysis-workflow.md`](references/analysis-workflow.md) before running any data query. This is mandatory after a KB hit identifies a saved asset, definition, parameter, time rule, conflict, or decision boundary; do not jump directly to ad-hoc analysis or SQL.
- Read operations can run directly after required inputs are known. Write operations require explicit user intent and normally keep the confirmation prompt unless the user asks to bypass it.
- Prefer
--dry-runbefore destructive or broad writes when the user has not already validated the target. - Do not invent knowledge base names, scopes, source IDs, source display names, or JSON payloads. Ask the user or query known context when values are missing.
- When building a
--sourcesref (or+read --source), copy the exactscopeandnamefrom+listoutput — runae-cli kb +listfirst when the scope of a named knowledge base is unknown. - JSON flags must be valid JSON strings, usually wrapped in single quotes in shell commands.
- Successful commands return JSON by default. Use
--format tableonly when a table is easier for a human to scan. Envelope may include optional_notice.host_compat. --host <url>overrides the active AE host. It is available on every command and may be placed after the subcommand, e.g.ae-cli kb +<command> --host <url>.- CRITICAL — Host compat (do this first): After each
ae-clirun, check stderr and_notice.host_compat. If either is present, open the user reply with a short ⚠️ version warning and quote the `npm i -g` / `npx skills add` (or update-cluster) lines verbatim, then present the business result. Soft tip;ok: truecan still carry the notice. - Retrieval (
+index/+grep/+read) is deterministic and server-side LLM-free; use it for simple factual lookups. Use+askwhen the question requires synthesizing across multiple pages or multi-hop reasoning.
Commands
| Command | Risk | Purpose |
|---|---|---|
source check-updates | write | Check one compiled Feishu source with the scheduled detector; mark changes without compiling. |
+ask | read | LLM-powered Q&A over knowledge bases; for multi-page synthesis or multi-hop questions. |
+ask-status | read | Query the current status of an ask execution by --execution-id without polling. |
+list | read | List accessible knowledge bases filtered by buildStatus (default: compiled). |
+list-sources | read | List source metadata for one knowledge base so exact source identifiers can be discovered safely. |
+index | read | List accessible knowledge bases and their index.md navigation maps. |
+grep | read | Keyword-search knowledge base pages; returns a page-level results array (hitCount / pageKind / sections previews). |
+read | read | Read a full knowledge base page, a line window, or (with --outline) only the page heading tree. |
+new | write | Create a new personal or company knowledge base. |
+import | write | Import a compiled Markdown ZIP as a personal or company read-only snapshot; --scope defaults to personal. |
+import-status | read | Query one snapshot import task by --request-id without polling; output includes the persisted scope. |
+add | write | Upload local files (including ZIP directory sources), a non-recursive directory, or HTTP(S) pages converted to markdown. |
+url | write | Upload a URL source directly with optional display name and parsing instruction. |
+schema | write | Generate the compile schema for a knowledge base. |
+compile | write | Compile a knowledge base in incremental or full mode. |
+status | read | Query the current status of a knowledge base. |
+rm-source | high-risk-write | Delete one source from a knowledge base by stable ID; exact display name is legacy compatibility only. |
+remove | write | Delete an entire knowledge base. |
Published Version History
Use the nine version commands described in `references/versions.md` to inspect immutable published history, compare source changes, and explicitly roll back an earlier version as a new publication. These commands manage history; +index/+grep/+read/+ask continue to use current published content.
| Command | Risk | Purpose |
|---|---|---|
+versions | read | List published versions and latestVersionId. |
+version-show | read | Show one version summary. |
+version-sources | read | Discover historical source IDs. |
+version-diff | read | Compare two versions. |
+version-tree | read | List a historical ZIP/URL source directory. |
+version-read | read | Preview a historical directory child file. |
+version-download | read | Save one ordinary historical file source; no directory download. |
+rollback | high-risk-write | Restore an earlier version and create a new version. |
+rollback-status | read | Query a persisted rollback Operation without polling. |
Source Draft Replacement and Restoration
Use `references/source-mutations.md` for file/ZIP source replacement and restoration. These new commands use kb source <action>; +rollback remains a whole-KB publication operation.
| Command | Risk | Purpose |
|---|---|---|
source replace | write | Replace an ordinary file draft, or prepare a ZIP archive replacement preview. |
source restore | write | Restore a file draft from a published version, or prepare a ZIP source/child restore preview. |
source preview | read | Read a page of ZIP candidate changes before confirmation. |
source commit | high-risk-write | Confirm a reviewed ZIP candidate, including any deletions. |
source cancel | high-risk-write | Discard an uncommitted ZIP candidate. |
Require exact --name, --scope, current --id, and a current --expected-revision for mutations. File replacements keep the original format but allow different filenames. ZIP requires .zip. URL/Feishu and deleted parent sources are not supported. Updates affect the draft only; publication still requires compilation. ZIP previews must not be auto-committed. Do not retry uncertain writes.
ZIP Directory Sources
Use +add --files '["./sources.zip"]' to upload one ZIP as one editable parent source, preserving its internal hierarchy. Archive validation and limits are enforced by the server. This is different from +import, which creates a read-only compiled snapshot. Passing a local directory to +add still uploads only its immediate supported files; it does not recursively package that directory.
Discover the exact parent ID with +list-sources. ZIP rows include fileCount, sizeBytes, contentRevision, and updateStatus.
| Command | Risk | Purpose |
|---|---|---|
+source-ls | read | List one directory page with revision, current children and deleted paths relative to the successful baseline. |
More from thinkingaiagenticengine
Use this skill in a project
Open any RiverX project, search the Skills panel for thinkingaiagenticengine/ae-cli/ae-kb, and install it in one click.