Knowledge and RAG

The CLI exposes two complementary surfaces for retrieval-augmented generation:

• knowledge — source lifecycle (list, add, remove, reindex, status) plus workspace search.
• rag — agent-facing retrieval and ingestion helpers (search, ingest, status).

Both commands call the sidecar. Loader credentials are never passed on the command line — provision secrets with vault put or secrets set first, then reference a location when adding a source.

Prerequisites

akos serve          # local sidecar (or point AKOS_HEADLESS_URL at a remote sidecar)
akos knowledge list

Manage sources

List sources

akos knowledge list
akos knowledge list --json

Add a source

# Local folder
akos knowledge add my-docs ./docs/product
 
# Remote kinds (credentials resolved server-side)
akos knowledge add handbook https://example.com/docs --kind url --name "Product handbook"
akos knowledge add repo-docs github:org/repo --kind github

Remove a source

akos knowledge remove my-docs

Drops the source and its index.

Reindex

akos knowledge reindex my-docs
# alias:
akos knowledge rebuild my-docs

Queues a full digest rebuild for one source.

Indexer status

akos knowledge status
akos knowledge status --json

Search

Search the workspace index (alias: query):

akos knowledge search "how do I configure egress"
akos knowledge search "onboarding checklist" --source my-docs --top-k 10 --json

The companion rag command exposes the same retrieval path for automation:

akos rag search "sandbox policy" --top-k 5 --json
akos rag ingest my-docs
akos rag status --json

Use knowledge when managing sources; use rag when scripting retrieval inside agent tooling.

Seed assistant documentation (operators)

To index the shipped documentation corpus so the in-app assistant can retrieve repo docs (beyond the always-on contract catalog), use the ledgered production seed:

# Preview what would be registered
akos prod seed --target assistant-knowledge --dry-run
 
# Apply folder sources + record the seed ledger
akos prod seed --target assistant-knowledge --apply
 
# Rebuild indexes after apply
akos knowledge reindex assistant-knowledge-for-agents
akos knowledge reindex assistant-knowledge-user-docs

Until rebuild completes, fumadocs pages are not in assistant RAG folder search — the contract catalog in the system prompt is always on.

Demo vertical packs

Materialise demo pack fixtures into sidecar stores (development / sales demos):

akos seed --vertical coding
akos prod seed --target demo --dry-run
akos prod seed --target demo --apply --vertical finance

Set AKOS_DEMO_PACKS=1 in the sidecar environment when demo packs are gated in your deployment.

Related topics

• Knowledge in the app — UI for sources and flow RAG nodes.
• Integration setup — OAuth providers for Notion/Drive/GitHub sources.
• Authentication — vault put and secrets set for loader credentials.
• Command reference — full knowledge / rag / prod seed tables.