ox kb
A Knowledge Bubble is a Curator-maintained, read-only synthesis of your team's distilled conversations for one area of work (see ox ADR-028). Team Contexts and Ledgers are separate, permanent conversation stores; they are not bubbles.
Use ox kb list to see the bubbles you can access, ox kb describe <slug> for details on one, and ox kb query to search their curated files.
Usage
Subcommands
| Command | Description |
|---|---|
ox kb list | List Knowledge Bubbles you can access |
ox kb describe <#slug|kb_id> | Describe a single Knowledge Bubble |
ox kb query <#slug|kb_id> [...] "<question>" | Search files across Knowledge Bubbles |
Examples
List the bubbles in this project's scopes, filtered to team-type bubbles. Inside an ox-initialized repo the ambient scope is the repo's team; personal-scope listing is deferred until personal-team provisioning rolls out.
Resolve a bubble by slug within the project's team and print its detail. The argument may be a kb_id, a slug, or a slug with the display # prefix; rename aliases are followed server-side.
Resolve platform in the named scope and emit scriptable JSON.
Search the curated files of one or more bubbles. The last argument is the search text, so quote it; every argument before it names a bubble, resolved within one scope like ox kb describe. Results are ranked file hits grouped per bubble in the order you named them; read each file from the bubble's local mount (ox kb describe shows the path).
A bubble you cannot read, one that does not exist, and one whose type is not indexed for search are all reported the same way, without revealing which it is.
Flags
| Flag | Description |
|---|---|
--type string | (ox kb list) Filter by kb type: personal, profile, team, repo, or custom |
--scope string | (ox kb describe, ox kb query) Scope to resolve a slug in: team or personal (personal is not yet available) |
-k, --k int | (ox kb query) Files per bubble (0 = server default; over-cap values are clamped) |
--mode string | (ox kb query) Retrieval mode: hybrid, bm25, or vector (bm25 skips the embedding step) |
--path string | (ox kb query) Only return files under this repo-relative path prefix |
What's next
- ox conversation - Browse the recorded conversations bubbles synthesize
- ox query - Search across Team Context beyond curated bubble files
- Team Context - The team-wide conversation store (not a bubble)