Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Filesystem Operations
OpenViking provides Unix-like filesystem operations for the viking://resources/ namespace.
Read Operations
ov read — Read L2 full content
ov read viking://resources/docs/api.md
Accepts file URIs only. Passing a directory returns INVALID_ARGUMENT (400) with structured details.expected="file", details.actual="directory" so clients can fall back to ov ls.
Parameters: uri (required), offset (line number, 0-indexed), limit (lines, -1 for all).
ov abstract — Read L0 abstract (~100 tokens)
ov abstract viking://resources/docs/
Directories only.
ov overview — Read L1 overview
ov overview viking://resources/docs/
Directories only.
ov ls — List directory contents
# Basic listing
ov ls viking://resources/
# Simple paths only
ov ls viking://resources/ --simple
# Recursive
ov ls viking://resources/ --recursive
Parameters: uri (required), --simple, --recursive, --show-all-hidden, --node-limit.
Entry fields: name, size, mode, modTime, isDir, uri, meta.
ov tree — Directory tree structure
ov tree viking://resources/my-project/
Parameters: uri (required), --show-all-hidden, --node-limit, --level-limit.
ov stat — File/directory status
ov stat viking://resources/docs/api.md
ov stat viking://resources/docs
For directories, returns count (estimated item count). isLocked reports whether a path lock or ancestor TreeLock is held.
Write Operations
ov write — Update or create a file
ov write viking://resources/docs/api.md \
--content "# Updated API\n\nFresh content." \
--wait
Modes:
replace(default): overwrite an existing file or create it when missingappend: append to an existing file or use the supplied content as a missing file's initial bodycreate: compatibility alias forreplace
New files accept .md, .txt, .json, .yaml, .yml, .toml, .py, .js, or .ts in every mode. --wait blocks until semantic/vector refresh completes. Parent directories are auto-created.
Derived semantic files cannot be written directly: .abstract.md, .overview.md.
ov mkdir — Create a directory
ov mkdir viking://resources/new-project/
ov mkdir viking://resources/new-project/ --description "API docs directory"
--description writes to .abstract.md and queues for L0 vectorization.
Modify Operations
ov rm — Remove file or directory
# Remove single file
ov rm viking://resources/docs/old.md
# Remove directory recursively
ov rm viking://resources/old-project/ --recursive
rm is idempotent: removing a non-existent valid URI succeeds. Invalid URI formats return INVALID_URI. Recursive delete returns estimated_deleted_count.
ov mv — Move file or directory
ov mv viking://resources/old-name/ viking://resources/new-name/
Search Operations
ov grep — Search by regex pattern
ov grep "authentication" --uri viking://resources/ --ignore-case
Parameters: uri, pattern (required), --ignore-case, --exclude-uri, --node-limit, --level-limit.
Response: matches with uri, line, content.
ov glob — Match files by glob pattern
ov glob "**/*.md" --uri viking://resources/
ov glob "**/*.py" --uri viking://resources/
Parameters: pattern (required), --uri, --node-limit.
WebDAV
OpenViking exposes a minimal WebDAV adapter at /webdav/resources:
- Resources only (memories, skills, sessions not exposed)
PUTaccepts UTF-8 text only- Supported methods:
OPTIONS,PROPFIND,GET,HEAD,PUT,DELETE,MKCOL,MOVE - Semantic sidecars and internal files are hidden
PUTdoes not auto-create parent collections; useMKCOLfirst- Creating or replacing a file triggers semantic generation