ctx
Reference

Changelog

Public ctx CLI release history.

0.25.0

2026-07-13

Added

  • Added an opt-in background daemon that keeps local history fresh, owns semantic indexing, and serves search queries without reopening the index for each command.
  • Added opt-in hybrid semantic search using the pinned intfloat/multilingual-e5-small model across the supported release matrix. Apple Silicon can use Core ML acceleration; managed ONNX Runtime sidecars provide the CPU path on Linux, macOS, Windows, and FreeBSD.
  • Added MiMo Code integration installers and coarse local hardware capability telemetry for release planning.

Changed

  • Lexical search now uses OR semantics by default and ranks conversational user and assistant messages ahead of lower-value event records.
  • Native refresh skips unchanged histories, avoids rescanning full-text rows, and bounds bulk import and WAL recovery work more carefully on large indexes.
  • macOS release binaries are now Developer ID signed and notarized.

Fixed

  • Updated Factory Droid, AstrBot, CodeBuddy, Junie, NanoClaw, and related native importers for current on-disk formats.
  • Fixed canonical handling for workspace and file filters, made upgrade errors visible in text status, and cleaned completed scheduled-upgrade state.
  • Cleaned temporary semantic model download state after verified installation and tightened cross-platform runtime validation.

Daemon maintenance and semantic search remain disabled by default in 0.25.0. After opting in through ~/.ctx/config.toml, run ctx setup; ctx status reports daemon state and semantic indexing coverage. Windows binaries are protected by signed release metadata and SHA-256 verification but are not yet Authenticode-signed.

Commits and PRs

0.23.0

2026-07-08

Added

  • Added multilingual scriptgram search so unspaced and mixed-script CJK, Kana, Hangul, Thai, Myanmar, and Indic queries can recall matching session and event text that SQLite FTS tokenizes poorly.
  • Added a v45 local schema migration that rebuilds the scriptgram search sidecars during normal CLI migration.

Changed

  • ctx setup now imports discovered local history in best-effort partial mode, keeping valid local sessions searchable when nearby provider files are empty or malformed.
  • Native import manifest handling now records malformed per-file failures without treating every file in the source as failed.

Fixed

  • Fixed bundled skill installs created before .ctx-skill.json metadata so known legacy ctx-agent-history-search copies upgrade as ctx-managed stale installs.
  • Fixed default skill installation so a custom same-name detected agent skill is preserved without failing the whole public installer flow.
  • Fixed Codex setup imports so an empty or malformed session file does not skip the entire Codex sessions source.
  • Fixed Antigravity setup imports so malformed transcript JSONL files are skipped while other valid Antigravity transcripts are indexed.
  • Fixed completed progress rendering so final plain and JSON progress reports show 100% completion instead of 0% ... done.

Commits and PRs

0.22.0

2026-07-08

Added

  • Added ctx integrations install/status mcp for supported coding-agent MCP configs, including structured config updates and conflict handling.
  • Added ctx integrations install slash-commands for supported command-file agents, with project and global scopes.
  • Added real harness smoke coverage for MCP, bundled skill, and slash-command integration flows.

Changed

  • Moved bundled agent skill install and status under ctx integrations install/status skills.
  • Native provider imports now use the updated public import policy defaults, retaining conversation text and safe metadata while skipping successful raw outputs and diffs.
  • The explicit-metadata development installer is now named scripts/dev-install-from-metadata.sh.
  • Public CI and release artifact checks now run through the hosted Buildkite pipeline configuration.

Fixed

  • Fixed oversized SQLite and JSONL handling so invalid or oversized records are skipped and reported without aborting nearby importable content.
  • Fixed OpenCode and Kilo message-part imports.
  • Fixed Python SDK handling of invalid UTF-8 from the local CLI.
  • Tightened README and install documentation around the current hosted and unmanaged install paths.

Commits and PRs

0.21.0

2026-07-07

Added

  • Added Linux ARM64 release asset support with the ctx-linux-aarch64 artifact name in the hosted release matrix.
  • Added public CI coverage and Bazel-modeled Rust crate checks for the public CLI repository.

Changed

  • ctx setup, ctx status, and ctx sources now share a clearer local-source inventory and scale better as supported provider coverage grows.
  • Added --quiet output handling for setup/status workflows so scripted installs can suppress non-essential success output.
  • Native imports are source-atomic by default, and provider identities are scoped by source so multiple local history roots stay distinct.
  • Provider listings now focus on importers that are supported by the public CLI.
  • Local redaction and share-safety state was removed from CLI storage, JSON output, and SDK contracts; local payloads and previews are stored directly.
  • Install documentation now covers unmanaged GitHub release assets, checksums, mise, Homebrew, and source-build behavior for the current release line.

Fixed

  • ctx status is now strictly read-only and will not initialize or repair local state.
  • Metadata-only provider imports are rejected before they create searchable history.
  • Setup, upgrade, and install diagnostics now report clearer lifecycle state.
  • Public CI setup, clippy coverage, and release-build environment handling were hardened for the current provider matrix.

Commits and PRs

0.20.0

2026-07-06

Added

  • Added native ctx skill install and ctx skill status support for the bundled ctx-agent-history-search skill.
  • Added installer setup integration for the bundled skill, including the universal .agents location and detected agent-specific skill folders.
  • Expanded supported local agent-history imports to 40 supported entries, including Warp, Windsurf, AstrBot, OpenClaw, Hermes Agent, NanoClaw, Shelley, Continue, OpenHands, Tabnine, Zed, Cline, Roo Code, and more.

Changed

  • Improved installer output and first-run setup guidance with clearer setup status and get-started commands.
  • Made source listing UX scale better as supported agent coverage grows by summarizing missing long-tail sources.
  • Updated docs and README references for native skill install and supported local agent history imports.

Fixed

  • Fixed --since overflow handling.
  • Fixed Windows home-directory discovery for provider locations.
  • Fixed read-only commands so they avoid unnecessary store initialization.
  • Fixed explicit import path and history-source manifest validation.
  • Fixed native JSONL import behavior for files without importable session headers.
  • Fixed whitespace-only search filters.
  • Fixed OpenCode import to index actual session messages.
  • Fixed MCP tool results to return readable text in content[0].text.
  • Fixed empty provider session validation.
  • Added parser, path, SQLite, timestamp, manifest, and resource-bound hardening across CLI/provider import paths.

Commits and PRs

0.18.0

2026-07-03

Added

  • Added hosted installer handoff marker support so managed installs can connect an install attempt to later CLI lifecycle events without copying marker contents into event properties.
  • Added a setup-start lifecycle event before setup completion.

Changed

  • Managed upgrades now preserve hosted installer handoff markers when rewriting install sidecars.

Commits and PRs

0.17.0

2026-07-03

Added

  • Added exact file-only search behavior for path-scoped queries.
  • Added SDK validation and error coverage for required search intent across the generated clients.

Changed

  • ctx search now requires explicit search intent; empty queries no longer fall back to broad results.
  • Native path imports now require an explicit provider.
  • Provider provenance is scoped by source so multi-source imports preserve distinct event and file-touch identities.
  • Local preview redaction docs now clarify that search output is local private transcript text, not share-safe redacted text.

Fixed

  • Hardened malformed config handling so invalid config fails loudly.
  • Hardened read-only search, doctor, upgrade diagnostics, and upgrade locking paths.
  • Skipped unreadable child directories while probing provider roots.
  • Initialized empty stores in refresh-off CLI tests.

Commits and PRs

0.16.0

2026-07-02

Added

  • Added ctx-history-jsonl-v1 imports for explicit JSONL interchange files.
  • Added local history-source plugins: a manifest plus script or binary command that streams ctx-history-jsonl-v1 records to stdout.
  • Added custom history-source filters and cursor handoff to CLI and MCP source/search flows.

Changed

  • ctx sources, ctx import, ctx search, and MCP source/search flows now understand custom history sources.
  • Search-time refresh can run enabled custom history plugins before querying.
  • Plugin docs are linked from the README, embedded docs, and ctx.rs site.
  • README and import-source UX were tightened.

Fixed

  • Fixed plugin timeout handling when helper descendants keep stdout or stderr open past the configured source timeout.
  • Improved the error for nonexistent import paths.

Commits and PRs

0.15.0

2026-07-01

Added

  • Added first-class local history import and search support for OpenClaw, Hermes, NanoClaw, and AstrBot.

Changed

  • Updated provider docs and fixture coverage for the new native sources.

Commits and PRs

0.14.0

2026-07-01

Added

  • Added experimental in-repo agent-history SDKs while keeping them non-publishing.
  • Added privacy-safe telemetry device identity support.

Changed

  • Cross-built macOS CLI artifacts from Linux with pinned Zig and cargo-zigbuild tooling.
  • Hardened release and archive coverage.
  • Renamed SDK contracts and docs around the agent-history naming.

Fixed

  • Fixed Swift SDK full-toolchain tests.
  • Cleaned up a clippy fixture issue in store archive-validation tests.

Commits and PRs

0.13.0

2026-07-01

Added

  • Added embedded docs for SQL, MCP, and upgrade topics.
  • Added ctx doctor progress output.
  • Added richer agent skill guidance for advanced ctx workflows.

Changed

  • ctx search excludes subagent sessions by default, with --include-subagents for explicit subagent coverage.
  • Search filter state and legacy JSON output were cleaned up.
  • Provider display names and provider filter docs were clarified.
  • Darwin CLI artifact generation can run from Linux through cargo-zigbuild.

Fixed

  • Fixed catalog import checkpoint state.
  • Kept checkpoint helper tests clippy-clean.
  • Suppressed weak embedded-doc search matches and added recovery suggestions.

Commits and PRs

0.12.0

2026-06-30

Added

  • Added ctx sql for one bounded, read-only SQL statement over the local store.
  • Added the MCP sql tool for advanced agent queries.
  • Added stable read-only views: ctx_sessions, ctx_events, ctx_files_touched, and ctx_sources.
  • Added SQL input from an argument, stdin, or --file.

Changed

  • SQL execution is bounded by rows, columns, SQL size, value size, SQLite allocation, and timeout limits.

Commits and PRs

0.11.0

2026-06-30

Added

  • Added signed managed upgrade checks and apply flow through ctx upgrade.
  • Added background auto-upgrade checks for hosted-installer-managed installs.
  • Added built-in documentation through ctx docs.
  • Added generated man pages through ctx docs man.

Changed

  • Hosted Unix and PowerShell installers verify signed CLI metadata, write managed install markers, and install generated Unix man pages.
  • Release metadata carries explicit self-upgrade and auto-upgrade policy flags.

Commits and PRs

0.10.0

2026-06-30

Added

  • Added touched-file metadata ingestion where provider transcripts expose file paths through tool calls, patches, commands, or native fields.
  • Added ctx search --file <path> examples and JSON contract notes for touched-file matches and citations.
  • Added the README token-efficiency chart.

Changed

  • Search output is described as local/private transcript text, not share-safe redacted text.
  • Older data roots can refresh derived search projections and re-read original provider transcripts when they still exist.
  • Agent skill docs were refreshed.

Commits and PRs

0.8.0

2026-06-29

Changed

  • Removed redundant top-level ctx list, ctx export, and ctx validate commands.
  • Kept ctx doctor as the storage health command.
  • Moved transcript file writing to ctx show session --out.
  • Updated docs, JSON contracts, security notes, and installed agent instructions for the smaller command surface.

Commits and PRs

0.7.0

2026-06-29

Changed

  • Removed the public top-level ctx research command and MCP research tool.
  • Kept history research as an agent workflow composed from ctx search, scoped ctx search --session, and ctx show.
  • Updated docs and agent skill instructions to use the composable commands.

Commits and PRs

0.6.0

2026-06-29

Added

  • Added the read-only MCP stdio server.
  • Added deterministic research packets and performance gates.
  • Added real-corpus search quality benchmarks.

Changed

  • Default search output became more compact and action-oriented, including inspect commands for follow-up retrieval.
  • Session transcript rendering defaults toward lite output.
  • ctx status source counting is faster.
  • Installed agent skill/plugin instructions were synced with the refined CLI flow.

Fixed

  • Satisfied strict clippy for the CLI UX changes.
  • Kept session metrics scoped to session-search results.

Commits and PRs

0.5.0

2026-06-27

Changed

  • Moved indexed history item counting into the store so setup/search checks no longer had to enumerate every session and event.
  • Avoided doing that count unless search had no results and needed a useful next step.
  • Updated package versions and public artifact checks for the release.

Commits and PRs

0.4.0

2026-06-26

Changed

  • Made search refresh incrementally import discovered native provider sources.
  • Preserved Codex tail state through recataloging.
  • Avoided global FTS rebuilds during normal refresh.

Fixed

  • Added regression and performance coverage for no-op and tail-refresh paths.

Commits and PRs

0.3.0

2026-06-26

Added

  • Added clearer provider source discovery and importability reporting for ctx sources.
  • Added Codex incremental import performance coverage.

Changed

  • Improved search refresh controls and freshness reporting.
  • Tightened hosted installer setup and search behavior.

Fixed

  • Fixed an incremental performance clippy lint.

Commits and PRs

0.2.0

2026-06-25

Added

  • Shipped the local SQLite index for agent-history sessions and events.
  • Supported setup, source discovery, import, search, show, locate, doctor, and JSON output for agent workflows.
  • Included native local-history imports for the first supported coding-agent formats.
  • Published hosted installers and cross-platform CLI artifacts.

Fixed

  • Fixed OpenCode import sequencing before the stable metadata refresh.

Commits and PRs