Skip to content

cli

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History
 
 

cli

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
bin
bin
 
 
README.md
README.md
 
 
package.json
package.json
 
 

README.md

@openviking/cli

Native CLI for OpenViking — an agent-native context database for AI workflows.

Store, search, and retrieve context (memories, resources, embeddings) across conversations and agents.

Install

npm i -g @openviking/cli

This installs the ov binary for your platform (macOS, Linux, Windows).

Alternative install methods

# via curl
curl -fsSL https://openviking.tos-cn-beijing.volces.com/cli/install.sh | bash

# one-shot with npx
npx @openviking/cli --help

Quick start

# Check connectivity
ov health

# Store context
ov add-resource ./notes.md
ov add-memory "key insight from today's debugging session"

# Retrieve context
ov find "what did I learn about caching?"
ov ls
ov read /path/to/resource

# Semantic search
ov search "authentication flow"
ov grep "TODO"

Commands

Data

Command Description
add-resource Add files or URLs into OpenViking
add-memory Store a memory in one shot
add-skill Add a skill from a directory or SKILL.md
ls List directory contents
tree Hierarchical tree view
read Read full file content
abstract Brief summary (L0)
overview Medium detail (L1)
write Write or append text content
find Semantic retrieval with scoring
search Context-aware retrieval (experimental)
grep Pattern search with regex
glob File glob pattern search
rm Remove a resource or directory
mv Move or rename a resource
stat Get resource metadata
get Download file to local path
session Manage sessions
export / import Backup and restore as .ovpack

Interactive

Command Description
tui Interactive file explorer
chat Chat with vikingbot agent

Status

Command Description
health Quick health check
status Show server components status
config Configuration management
version Show CLI and server version
task Track async processing tasks

Supported platforms

Platform Architecture Package
macOS Apple Silicon @openviking/cli-darwin-arm64
macOS Intel @openviking/cli-darwin-x64
Linux x64 @openviking/cli-linux-x64
Linux ARM64 @openviking/cli-linux-arm64
Windows x64 @openviking/cli-win32-x64

Links

License

Apache-2.0