OpenViking (OV) Resource Management
The ov command group for resources covers adding external knowledge, filesystem operations, scheduled refresh (watch tasks), and ovpack import/export/backup/restore.
Goal
Guide an agent to correctly invoke resource and filesystem commands without guessing flags, URI semantics, or processing behavior.
Load When
- User explicitly requests resource operations:
ov add-resource,ov task watch,ov export,ov import,ov backup,ov restore. - User asks to browse, read, write, create, move, or delete files under
viking://resources/. - User asks to search for context:
ov find,ov search,ov grep,ov glob. - Agent needs to list, inspect, or search the resource tree to find context.
Inputs
| Name | Required | Description |
|---|---|---|
subcommand |
yes | Resource command: add-resource, task watch, export, import, backup, restore, filesystem command: ls, tree, read, write, mkdir, rm, mv, grep, glob, or search command: find, search |
target |
conditional | File path, URL, Viking URI, or query string |
flags |
no | Command-specific flags like --wait, --to, --parent, --recursive, --watch-interval |
Workflow
- Identify the user's intent and map to the correct
ov <subcommand>. - Resolve the target (local path, URL, or Viking URI).
- Construct the command with appropriate flags.
- Execute and report results.
Permissions
ov add-resourcefrom external URLs may download untrusted content; verify the source when the user provides an untrusted URL.ov rm --recursiveis destructive; confirm with the user before executing on large directories.ov export,ov import,ov backup,ov restorerequire ROOT or ADMIN permissions.ov writereplaces file content in-place; the old version is not retained.
Output
- CLI output returned directly to the user.
- Errors surfaced with suggested fixes and relevant flag guidance.
Verification
- After
add-resource,ov lsorov treeshould show the new resource under the expected URI. - After
rm,ov lsshould no longer list the removed path. - After
write,ov readshould reflect the new content. - After
ov importorov restore,ov treeshould show the imported structure.
Boundaries
- Do not invent paths or URLs. Use what the user provides.
- Do not execute
ov rm --recursiveon broad paths likeviking://resources/without explicit user confirmation. - Do not treat
ov add-skillorov skillsas equivalent to resource commands; skill management is handled byov-skills. - Do not treat
ov add-memoryas a resource command; memory management is out of scope for this skill.
Runtime Resources
docs/add-resource.md— detailed resource ingestion docs, source types, and async processing.docs/filesystem.md— filesystem operations reference (ls, tree, read, write, mkdir, rm, mv, grep, glob).docs/search.md— semantic search (ov find,ov search) and search combination strategies.docs/watch-management.md— watch task lifecycle (create, pause, resume, trigger, update, remove).docs/ovpack.md— ovpack export/import/backup/restore reference.examples/commands.md— common command patterns by scenario.