openvikinglisted
Install: claude install-skill znuaibot/openviking-skill
# OpenViking context database
OpenViking stores all agent context (Memory / Resource / Skill) as a virtual
directory structure with semantic search and L0/L1/L2 progressive loading.
## Local deployment (already running)
| Item | Value |
|------|-------|
| **Server** | `http://localhost:1933` (v0.4.15, auth=trusted) |
| **API key** | `f0295b83557506298fb9be1df4bf4be059d5c764ffb2b5d79799ae7209616073` |
| **Account/User** | `hermes` / `hermer-one` |
| **CLI** | `openviking` (installed at `~/.local/bin/openviking`) |
| **MCP endpoint** | `http://localhost:1933/mcp` (streamable HTTP, 15 tools) |
| **WorkBuddy MCP** | Configured in `~/.workbuddy/mcp.json` as `openviking` (streamableHttp) |
| **Embedding** | ollama `qwen3-embedding:4b` (dim=1024, localhost:11434) |
### Three usage paths
**1. CLI** (already configured):
```bash
openviking find "query" --limit 5
openviking ls viking://~/
openviking read viking://resources/foo.md
```
**2. MCP** (configured in WorkBuddy — restart WorkBuddy to activate):
Tools: find, search, read, list, tree, remember, write, edit, add_resource, list_watches, cancel_watch, grep, glob, forget, health
**3. Python SDK**:
```python
from openviking_sdk import SyncHTTPClient
client = SyncHTTPClient(url="http://localhost:1933", api_key="f0295b...")
results = client.find("authentication", target_uri="viking://resources/docs/")
```
## Core concepts
| Concept | Summary |
|---------|---------|
| **Context types** | Resource (external knowledge), Memory (ag