Loading...
Loading...
Activate when the user asks about any repository listed in the system prompt under 'OpenViking — Indexed Code Repositories', or when they ask about an external library, framework, or project that may have been indexed. Also activate when the user wants to add, remove, or manage repos. Always search the local codebase first before using this skill.
npx skill4agent add volcengine/openviking openvikingovbashviking://viking://
└── resources/
├── fastapi/ ← repo A
│ ├── fastapi/
│ │ ├── routing.py
│ │ └── dependencies/
│ └── tests/
└── requests/ ← repo B
├── requests/
└── tests/abstractoverview| Command | Use when | Example |
|---|---|---|
| You know the concept but not the exact code | "dependency injection", "rate limiting logic" |
| You know the exact keyword or symbol | function name, class name, error string |
| You want to enumerate files by pattern | all |
# Semantic search — concept/intent based
ov find "dependency injection" --uri viking://resources/fastapi --limit 10
ov find "how tokens are refreshed" --uri viking://resources/fastapi/fastapi/security
ov find "JWT authentication" --limit 10 # across all repos
# Keyword search — exact match or regex
ov grep "verify_token" --uri viking://resources/fastapi
ov grep "class.*Session" --uri viking://resources/requests/requests
# File enumeration — by name pattern (--uri is required)
ov glob "**/*.py" --uri viking://resources/fastapi
ov glob "**/test_*.py" --uri viking://resources/fastapi/tests
ov glob "**/*.py" --uri viking://resources/ # across all repos--uri# Directories: AI-generated summaries
ov abstract viking://resources/fastapi/fastapi/dependencies/ # one-line summary
ov overview viking://resources/fastapi/fastapi/dependencies/ # detailed breakdown
# Files: raw content
ov read viking://resources/fastapi/fastapi/dependencies/utils.py
ov read viking://resources/fastapi/fastapi/dependencies/utils.py --offset 100 --limit 50abstractoverviewreadov ls viking://resources/ # list all indexed repos
ov ls viking://resources/fastapi # list repo top-level contents
ov tree viking://resources/fastapi # full directory treeov add-resource https://github.com/owner/repo --to viking://resources/ --timeout 300
ov add-resource /path/to/project --to viking://resources/ --timeout 300--timeoutov observer queue| Repo Size | Files | Est. Time |
|---|---|---|
| Small | < 100 | 2–5 min |
| Medium | 100–500 | 5–20 min |
| Large | 500+ | 20–60+ min |
ov rm viking://resources/fastapi --recursivecommand not found: ovpip install openviking --upgrade --force-reinstallurl is requiredCLI_CONFIGmkdir -p ~/.openviking && echo '{"url": "http://localhost:1933"}' > ~/.openviking/ovcli.confCONNECTION_ERROR~/.openviking/ov.confopenviking-server --config ~/.openviking/ov.conf > /tmp/openviking.log 2>&1 &
for i in $(seq 1 10); do ov health 2>/dev/null && break; sleep 3; done~/.openviking/ov.confov help
ov <command> --help # e.g. ov find --help