Skip to content

Knowledge CLI

Use provon knowledge to materialize active project Knowledge as local Markdown and find relevant items deterministically. You can also manage Learning Goals, Knowledge Items, and K

View as Markdown Open the plain-text version of this page.

Pull Project Knowledge#

bash
provon knowledge pull

The default output is .provon/knowledge. The command writes one managed Markdown snapshot for the active project and records a manifest so local modifications can be detected.

Choose another directory or replace a modified snapshot:

bash
provon knowledge pull --out ./project-knowledge
provon knowledge pull --out ./project-knowledge --force

Find Knowledge#

bash
provon knowledge find "deployment region"
provon knowledge find "response format" --goal <goal-id> --limit 10

Matching is deterministic and requires every normalized search term to appear in the item title, content, or Learning Goal name.

Select an output format:

bash
provon knowledge find "deployment region" --format json
provon knowledge find "deployment region" --format md
provon knowledge find "deployment region" --format paths

paths returns the generated Markdown files associated with matching goals and is useful when providing focused context to a coding agent.

Inspect The Snapshot#

bash
provon knowledge status
provon knowledge status --out ./project-knowledge

Status verifies the managed manifest and reports whether the local snapshot is current and intact.

Manage Learning Goals#

List goals:

bash
provon knowledge goals list
provon knowledge goals list --status active --limit 50

Goal statuses: active, archived.

Create a goal:

bash
provon knowledge goals create "Deployment constraints" \
  "Extract all region and quota constraints mentioned in conversations." \
  --status active

Inspect and update a goal:

bash
provon knowledge goals get <goal-id>
provon knowledge goals update <goal-id> --name "Updated name"
provon knowledge goals update <goal-id> --instruction "New instruction"
provon knowledge goals update <goal-id> --status archived

Archive a goal:

bash
provon knowledge goals archive <goal-id>

Backfill a goal over historical conversations:

bash
provon knowledge goals backfill <goal-id> \
  --start 1755216000000 \
  --end 1755302400000 \
  --max-conversations 1000

Manage Knowledge Items#

Inspect and update an item:

bash
provon knowledge items get <item-id>
provon knowledge items update <item-id> --title "Updated title"
provon knowledge items update <item-id> --content "Updated content"
provon knowledge items update <item-id> --status active

Item statuses: active, reviewing, archived, rejected.

Knowledge Settings#

Show or update automatic knowledge extraction:

bash
provon knowledge settings get
provon knowledge settings set-extraction true
provon knowledge settings set-extraction false