Skip to main content
Lessons are reusable instructions, domain facts, and operating rules that Sovara can retrieve for future agent runs. Every sovara lessons subcommand requires --project-id. The selector accepts a full project ID, an unambiguous ID prefix, or an exact project name. Examples below use a shell variable to keep commands readable:

​
List and read lessons

ls returns lessons and immediate child folders. Omit the path or pass "" to list the root folder. Add -R / --recursive to include compact lesson records from descendant folders; full lesson content is omitted. get returns complete lesson details. Multiple comma-separated IDs are returned under a lessons array in the requested order.

​
Retrieve lessons for context

Use retrieve to see which lessons match concrete agent context. Optionally scope retrieval to a folder with --path / -p.

​
Create a lesson

Creation requires a title, content, and retrieval-oriented usage hint:
When a lesson comes from a specific step, pass the full source run UUID and the step ref shown by sovara probe. Sovara resolves the ref to a durable step UUID before creating the lesson. Omit both flags when the lesson has no concrete run provenance.

​
Improve a lesson

Ask for a non-mutating wording proposal:
Apply an update:

​
Manage folders

Use restructure commands only when intentionally reorganizing a larger lesson taxonomy. Pass the same explicit project selector to every command.