ContextOS v1.0.0: Smarter Context, Better Agents

ContextOS v1.0.0

Released August 4, 2026.

ContextOS v1.0.0 is the first stable release of the local-first semantic context engine for coding agents. It indexes repositories into a SQLite-backed semantic graph and exposes focused retrieval through MCP and the CLI.

Highlights

• Function-level AST and Markdown indexing across the documented language set.
• Precision-first context assembly with token budgets, line-ranged stubs, and symbol expansion.
• FTS5/RRF retrieval with graph expansion and optional local MiniLM embeddings.
• Incremental indexing plus a background daemon that rebuilds automatically when the indexer format changes.
• Persistent facts, session memory, retrieval feedback, and local SQLite storage.
• Path and symlink boundary enforcement for file access, indexing, and command execution.

Stable surfaces

From v1.0.0 onward, the documented CLI commands, default MCP tool names and input schemas, and configuration keys follow the guarantees in STABILITY.md. The SQLite index remains ephemeral and rebuildable rather than a stable public schema.

Upgrade

Upgrade the package and restart your MCP client:

npm install -g @siddharthakatiyar/contextos@1.0.0

The daemon automatically schedules a full rebuild when the indexer format changes. See UPGRADING.md for configuration and compatibility details.

Security

ContextOS confines repository file operations to the configured workspace and uses an allowlist for ctx_execute. Repository scripts remain enabled by default for trusted projects; disable them with execAllowRepoScripts: false when working with untrusted code. See SECURITY.md for the complete threat model and accepted dependency risks.