Releases

Changelog and technical updates.

$npm i -g @siddharthakatiyar/contextos && contextos init
AI Agent using ContextOS
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

v1.0.1

Patch Release

  • - Docs
04 Aug 2026

v1.0.0

Minor Release

  • - v1.0.0 Stable
27 Jul 2026

v0.9.5

Patch Release

  • - Release version bump to `v0.9.5`.
26 Jul 2026

v0.9.4

Patch Release

  • - Token Clamping & Optimizations
  • - Auto-Reindexing
  • - Trigram FTS
25 Jul 2026

v0.9.3

Patch Release

  • - Parser Engine
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

v0.7.0

Major Release

  • - Breaking Change
10 Jul 2026

v0.6.0

Minor Release

  • - RRF Fusion Retrieval
  • - Query-Aware Compile
  • - Hardened MCP Tools
10 Jul 2026

v0.5.0

Minor Release

  • - Tiered Compile
  • - Retrieval Precision
07 Jul 2026

v0.4.0

Minor Release

  • - Security Patches
  • - Stability Improvements
06 Jul 2026

v0.3.0

Minor Release

  • - Cross-Session Memory
  • - Smart Context Assembly
  • - Graph Visualization
09 Jun 2026

v0.2.0

Initial Release

  • - Basic File Retrieval
  • - CLI Interface