Knowledge base

Browse, search, and inspect your knowledge base pages, sources, citations, and knowledge graph from the command line.

All beakr kb commands support these common flags:

Flag	Description
`--project, -P`	Scope to a specific project
`--mine, -m`	Limit to your personal space
`--json, -j`	Output raw JSON (for piping)

List pages

beakr kb ls
beakr kb ls --type topic
beakr kb ls --roots
beakr kb ls --parent "project-overview"
beakr kb ls --limit 20

Filter by page type (topic, person, organization, decision, meeting, overview, research_note), show only root pages, or list children of a specific page.

Read a page

beakr kb cat "project-overview"
beakr kb cat "Project Overview"
beakr kb cat abc123-uuid --rev 3

Read the full content of a page by slug, title, or UUID. Use --rev to fetch a specific revision.

Search

beakr kb search "authentication flow"
beakr kb search "Q3 decisions" --limit 5

Semantic and keyword search across all pages. Returns matching pages with snippets.

Grep

beakr kb grep "API endpoint"
beakr kb grep "deadline"

Search page content by keyword or pattern.

Blame

beakr kb blame "project-overview"

Show paragraph-level source attribution. See which source documents contributed to each section of a page.

Sources

beakr kb sources "project-overview"

List all source documents that contributed to a page.

Provenance

beakr kb provenance "project-overview"

Show section-level citations with stance indicators: supports, contradicts, or qualifies.

Links

beakr kb links "project-overview"

Show all pages that link to this page (backlinks).

Timeline

beakr kb timeline
beakr kb timeline "hiring" --start 2026-01-01 --end 2026-03-31
beakr kb timeline --type decision --content

Query temporal events (decisions, meetings, etc.) across the knowledge base. Filter by date range, keyword, or page type. Use --content to include full section markdown.

Log

beakr kb log
beakr kb log "project-overview"

Without a page argument, shows recent ingestion events (new documents processed). With a page argument, shows the revision history for that page.

Graph

beakr kb graph

Dump the knowledge graph structure: total nodes and edges, and the top connected pages.

Stats

beakr kb stats

Show knowledge base statistics: total page count and source count.