Export & import

Move standards, skills, and sessions between machines as portable JSONL.

Export packages parent entities (standards, skills, sessions) with their sections and chunks. Import assigns fresh IDs and remaps relations — safe for sharing knowledge without copying raw database files.

orkai export

orkai export my-project
orkai export my-project --exclude=session
orkai export ad7e --output=backup.orkai.jsonl

Writes <category-name>.orkai.jsonl by default.

Options

Option	Description
`--exclude=type,…`	Skip parent types: standard, skill, session
`--output path`	Output file path

orkai import

orkai import my-project backup.orkai.jsonl
orkai import my-project https://example.com/shared.orkai.jsonl
orkai import my-project backup.orkai.jsonl --dry-run
orkai import my-project backup.orkai.jsonl --re-embed

Target category is created if it does not exist. Use --dry-run to validate without writing.

Options

Option	Description
`--dry-run`	Validate the file and report counts without writing anything.
`--re-embed`	Ignore any embedding vectors stored in the export file and re-embed every entity with the target daemon's configured embedding model. Use this when the source and target machines use different embedding providers or dimensions — reusing exported vectors would otherwise fail with a dimension mismatch.

Typical uses

Back up standards and skills before a major re-index
Share a team skill pack via URL
Clone knowledge to a second machine (export → import into a new category)