docs/en/about/02-changelog.md
All notable changes to OpenViking will be documented in this file. This changelog is automatically generated from GitHub Releases.
headers for traces, logs, and metrics, enabling direct connection to backends that require extra auth or gRPC metadata..gitignore rules, reducing noise from build artifacts and temp files.search and find now accept multiple target URIs for cross-directory and cross-repo retrieval.agent_prefix as prefix-only; OpenCode memory plugin adds tenant header forwarding.headers across all three exporter types (gRPC metadata in gRPC mode, HTTP headers in HTTP mode)..gitignore by default — previously imported temp/generated files may be excluded after upgrade.agent_prefix is now prefix-only and no longer treated as a full agent identifier; docs migrate agentId → agent_prefix.openviking-server now exposes /mcp on the same port as the REST API, reusing API-Key auth and providing 9 tools (search, read, list, store, add_resource, grep, glob, forget, health)./api/v1/privacy-configs API and openviking privacy CLI for managing sensitive skill settings with version history and rollback.server.observability config enables Prometheus /metrics and OpenTelemetry exporters for metrics, traces, and logs.embedding.text_source, embedding.max_input_tokens, retrieval.hotness_alpha, and retrieval.score_propagation_alpha controls.viking:// URI validation; standard error envelopes for processing/zip/HTTP errors./app/.openviking; missing ov.conf returns 503 initialization guide instead of crashing.encryption.api_key_hashing.enabled must now be configured explicitly (defaults to false). If you relied on implicit hashing, add it to your config.agentId → agent_prefix, recallTokenBudget → recallMaxInjectedChars.vlm.timeout for per-request HTTP timeouts.volcengine.api_key data-plane mode for accessing pre-created cloud VikingDB collections and indexes with an API key.write(mode="create") for creating new text resource files and automatically refreshing related semantics and vectors.OPENCLAW_STATE_DIR support for the OpenClaw plugin.recallTokenBudget and recallMaxContentChars to reduce the risk of overlong OpenClaw auto-recall context injection.ov add-memory now returns OK for asynchronous commit workflows instead of implying the background task has already finished.ov chat now reads authentication from ovcli.conf and sends the required request headers.role_id handling with the server multi-tenant model.toolResult errors caused by incompatible OpenClaw tool-call message formats.add_resource target fields, repo target URIs, filesystem mkdir, and the reindex maintenance route..bat environment read/write, shell escaping, ov.conf validation, and hardcoded paths.cache_control 400 errors for Gemini + tools and added support for OpenAI reasoning model families.ov_import and ov_search in the plugin, and extended Phase 2 commit wait timeout.openviking-server init wizard for local Ollama deployment and added a default file/dir ignore config for ovcli.conf.Memory V2 is now the default memory pipeline, featuring a redesigned format, refactored extraction and dedup flow, and improved long-term memory quality.
openviking-server init).extra_headers).upload.ignore_dirs in ovcli.conf to reduce noisy uploads."memory": { "version": "v1" } in ov.conf.ov init / ov doctor → openviking-server init / openviking-server doctor.extra_headers for required headers.storage.agfs.s3.disable_batch_delete.disable_batch_delete option to S3FS for OSS compatibility and improved RAGFS path scope fallback to prefix filters.afterTurn stores messages with correct roles while skipping heartbeat entries.recallPreferAbstract and ingestReplyAssist now false); eval scripts and recall query sanitization added.main on release, Docker Hub push, Gemini optional dependency in image.recallPreferAbstract and ingestReplyAssist now default to false — enable explicitly if needed.gateway.mode, e2e healthcheck tool, bypass session patterns, fault isolation from OpenViking.session_id; CLI chat endpoint priority and grep --exclude-uri/-x enhanced.gateway.mode — manage explicitly after upgrade.--with-bot failures now return error codes; scripts relying on "fail-but-continue" need adjustment.embed().litellm dependency updated to >=1.0.0,<1.83.1.ov.conf on auto install.agent-only memory scope, multi-tenant usage guide..cc file recognition, duplicate title filename conflict fix, upload-id based HTTP upload flow.parent_uri removal, Docker doctor alignment, eval token metrics./bot/v1/chat and /bot/v1/chat/stream now require authentication.temp_upload → temp_file_id flow.openclaw >= v2026.3.22.This patch release stabilizes the server shutdown sequence by properly handling CancelledError, rolls back a bot configuration regression, and tightens the Docker build by switching to uv sync --locked for reproducible dependency resolution.
ov reindex, ov doctor, Prometheus exporter, memory health stats API, trusted tenant header mode, Helm Chart.litellm security policy: temporarily disabled, then restored as <1.82.6 — pin your dependency version explicitly.Emergency hotfix due to a supply chain security incident in the upstream LiteLLM dependency. All LiteLLM-related entry points are temporarily disabled.
litellm is installed in your environmentLiteLLM features will remain unavailable until a trusted upstream fix is released.
This release focuses on stability and developer experience improvements. Key fixes address RocksDB lock contention by sharing a single adapter across account backends, restore previously lost plugin bug fixes, and improve vector store incremental updates. New features include a bot debug mode with /remember command support, summary-based file embedding in the semantic pipeline, and comprehensive PR-Agent review rules for CI. Documentation also received Docker Compose and Mac port forwarding guidance.
agentId.used() tracking interface..doc/.xls parser support, path locking and crash recovery.<think> tag cleanup.ov chat with rustyline line editing, Markdown rendering, chat history.wait parameter, configurable worker count.add-resource tool, Feishu progress notifications.add_resource now supports index control with refactored embedding logic and correctly handles ZIP-based container formats.add_message() adds parts parameter support; semantic indexing triggered for parent directories after memory extraction.VikingURI support, git@ SSH URL format in the CLI, and GitHub tree/<ref> URL for code repository import.agfs gains ripgrep-based grep acceleration and async grep support with optional binding client mode; automated PR review workflows using Doubao model with severity classification.uv pip install -e ..Datasets and indexes generated by previous versions are incompatible with this release and cannot be reused. A full rebuild is required after upgrading to avoid retrieval anomalies, inconsistent filtering, or runtime errors. Stop the service, remove your workspace directory (rm -rf ./your-openviking-workspace), then restart with openviking-server.
This release delivers CLI optimizations including glob -n flag support and cmd echo, alongside README updates for both English and Chinese documentation.
Before upgrading, stop the VikingDB Server and clear your workspace directory. Indexes from prior versions are not forward-compatible with this release.
This release adds C# AST extractor support for code parsing, fixes multi-tenant filtering, normalizes OpenViking memory target paths, and improves git repository detection with git@ SSH URL support. The agfs dependency libraries and binaries are now pre-compiled, eliminating the need for a build step at install time. Documentation adds Qwen model usage instructions.
openclaw-openviking-plugin installation, opencode plugin introduction.ov command wrapper, add-resource enhancements, ovcli.conf timeout support, --version flag.Updated CLI binary release with cross-platform support for macOS and Linux, aligned with the v0.1.18 feature set including the Rust-based implementation and expanded file parser capabilities.
This release brings major new capabilities to OpenViking. A high-performance Rust CLI is introduced alongside a terminal UI for filesystem navigation. File parsing is significantly expanded with support for Word, PowerPoint, Excel, EPub, and ZIP formats. Multi-provider support is added for embedding and VLM backends. Memory handling is redesigned with conflict-aware deduplication and a new extraction flow.
ov tui).Initial CLI binary release with cross-platform support for macOS and Linux, providing a standalone distributable for OpenViking server management and resource operations.
A stability-focused patch release. Reverts dynamic project name configuration in VectorDB due to instability, fixes CI workspace cleanup, and resolves a tree URI output error with added validation of ov.conf on startup.
A focused bug-fix and improvement release. Fixes VectorDB connectivity issues and a server conflict between uvloop and nest_asyncio. Temporary URIs are now human-readable, resource add timeouts are enlarged, and dynamic project name configuration is introduced for VectorDB and Volcengine backends.
This release focuses on architectural refactoring and reliability improvements. The HTTP client is split into distinct embedded and HTTP modes for cleaner separation of concerns. The CLI launch speed is improved through directory restructuring. VectorDB timestamp and collection creation bugs are resolved.
ls and tree output.A major infrastructure release. An HTTP server and Python HTTP client are introduced, enabling remote access to OpenViking services. The OpenClaw skill adds MCP integration support. Directory pre-scan validation, DAG-triggered embedding, and parallel resource addition improve performance and reliability.
~/.openviking.This release improves search quality, storage reliability, and code maintainability. Sparse logit alpha search is added for enhanced retrieval. Query embeddings are reused in the hierarchical retriever for better performance. Native VikingDB deployment is now supported. A critical Zip Slip path traversal vulnerability (CWE-22) is patched.
Adds support for ingesting small GitHub code repositories, enabling OpenViking to index and search public codebases directly.
Patch release fixing a compilation error and resolving a Windows binary release packaging issue.
The initial public release of OpenViking. This release establishes the core project structure with cross-platform support including Linux and Intel Mac. It introduces the service layer architecture, separating embedding and VLM backends into configurable providers. Memory deduplication is improved and retrieval recursion bugs are fixed. Python 3.13 compatibility, S3FS support, and usage examples for chat and memory workflows are included.