ctx
Reference

Changelog

Public ctx CLI release history.

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