Skip to main content
Knowledge folders are the same “tag” set the library sidebar shows. Each folder is a slice of documents Agents can retrieve from. Access rules gate which tenant roles can see which folder’s documents. Both surfaces live under nora knowledge.

Command groups

  • Folders: knowledge folders list/add/delete
  • Access rules: knowledge access list/set

Folders

List

Prints every folder registered in the workspace (staged list).

Add

Creates an empty folder. Idempotent: no-op if the folder already exists. Use this before tagging documents into a new folder so the sidebar picks it up.

Delete

Removes the folder from the staged list. Documents tagged with it stay put. Untag or delete the documents first if you want the folder truly gone.

Access rules

Rules are {folder → {partitionKey?, requires[]}}. requires is a set of tenant permissions the caller must hold to see the folder. partitionKey optionally scopes the folder by an operator-defined key (e.g. per-region, per-customer).

List

Prints all rules currently in effect.

Set

Empty --partition-key + empty --requires deletes the rule row.

Recipes

Bootstrap a folder + rule pair

Snapshot the folder / access shape to git

Round-trip candidate: commit these to track policy changes.

See also