Releases
Changelog and technical updates.
$npm i -g @siddharthakatiyar/contextos && contextos init

20 Nov 2026
v1.2.1
Patch Release- - Global npm installation leaves user-wide agent instructions unchanged; use `contextos enable` explicitly to install or refresh them. Automatic existing-project migration remains a separate control.
- - Document 1.2.0's independent global-instruction and project-migration opt-outs, deferred first-use migration, and manual removal of older managed blocks.
- - Validate direct 1.0.3 upgrades and saved-data recovery, and packed installs on Linux, macOS and Windows before publication.
- - Publish the exact checksum-verified tarball that passed validation, without rebuilding from the checkout.
- - Update the documentation site's Next.js dependency to 16.4.6 to address GHSA-mfr8-8qww-v76h and unblock fresh builds.
15 Nov 2026
v1.2.0
Minor Release- - Wait for the live workspace daemon to watch a newly indexed or re-added project before initialization returns, preventing immediate queries from racing its first scan.
- - Restart verified daemons on the first setup for a new version even when an older process reads the replaced package manifest; new daemons retain their startup version.
- - Keep default indexing progress on stderr so the first `contextos query --json` remains valid JSON while a migrated or unindexed project rebuilds.
- - Validate the installable package in isolated user homes, including automatic migration, cold JSON queries, grouped retrieval, and MCP use before publishing.
- - Update package metadata and managed instruction blocks for 1.2.0.
15 Nov 2026
v1.1.1
Patch Release- - Add `ctx_trace` for bounded, directed traversal of recorded verified links, with ordered witness paths, citations, explicit gaps and scope isolation.
- - Add on-demand `ctx_resolve_import` and `ctx_contract` tools. Agents can inspect exact local dependencies and OpenAPI/gRPC operations during normal work, then save established relationships with `ctx_link`. No background agent discovery or model calls are added.
- - Index protobuf RPC signatures, OpenAPI operations/schemas and Go module manifests. Advance the indexer version so selected views rebuild with the updated parser.
- - Save exact local JS/TS file dependencies during combined retrieval with deterministic provenance and fresh mapping evidence. Surface unresolved local imports as transient suggestions; preserve existing agent-authored links.
- - Global npm installs enable managed instructions for detected supported coding agents by default; local installs do not. Add `contextos enable` for refresh and `CONTEXTOS_GLOBAL_INSTRUCTIONS=0` to opt out during installation.
03 Nov 2026
v1.1.0
Minor Release- - Add `contextos doctor` diagnostics and `contextos query --explain` retrieval and compilation details.
- - Add read-only `contextos upgrade --dry-run` plans for recognized global npm, local npm/pnpm/Yarn, and source-checkout installs.
- - Fix doctor configuration discovery and improve daemon read/expand helper behavior.
- - Enable automatic stable patch updates by default before MCP `serve` on supported Linux global npm installs. Updates stay within the installed major/minor line, use staged verification and rollback, and can be disabled with `contextos updates policy notify`.
02 Nov 2026
v1.0.3
Patch Release- - Update the Next.js documentation toolchain and runtime dependency lock records to patched releases.
- - Refresh dependency overrides for URI parsing, HTTP middleware, and query-string handling.
- - Synchronize the package and documentation workspace versions, dependency inventory, and CycloneDX SBOM for v1.0.3.
22 Sept 2026
v1.0.2
Patch Release- - Indexing integrity
- - Chunking and retrieval
- - Daemon reliability
- - Workspace isolation
- - Script execution is opt-in
15 Aug 2026
04 Aug 2026
27 Jul 2026
26 Jul 2026
25 Jul 2026
23 Jul 2026
v0.9.2
Patch Release- - AI Agents now automatically receive semantic retrieval instructions during `contextos init`, ensuring they prioritize `get_context` before falling back to expensive file exploration.
- - Massive filesystem events (such as `git checkout`, `git switch`, or `npm install`) are now intelligently coalesced into a single background re-index instead of triggering thousands of individual updates.
- - Better defaults for AI coding workflows with no additional configuration.
- - Any AI Agent (via automatic configuration generation)
- - MCP clients supporting the official `instructions` field
22 Jul 2026
v0.9.0
Minor Release- - Path Traversal Guards
- - Malicious Repo Protection
- - DOS Protection
- - `execAllowRepoScripts` opt-out
- - `STABILITY.md`
20 Jul 2026
v0.8.0
Major Release- - Background Daemon Indexing
- - Local SQLite Architecture
- - Retrieval Benchmarks
- - Hybrid Embedding Fusion
- - Update Notifier
19 Jul 2026
v0.7.1
Minor Release- - Comprehensive Next.js Documentation site at `/docs`.
- - New `contextos status --json` output for IDE plugins and CI tracking.
- - Interactive terminal metrics and visualization for Graph Expansion limits.
- - Fixed cyclical import detection during AST chunking which caused infinite loops in specific Monorepo setups.
16 Jul 2026
10 Jul 2026
10 Jul 2026
07 Jul 2026
06 Jul 2026
09 Jun 2026