v0.3.25 — One-command install

Install

pip install ctx-retriever

Hooks wire automatically. No ctx-install needed.

Changes

• Removed ctx-install from user-facing install flow
• Removed Option A/B install split from README
• Removed ctx-install subcommands section
• Removed manual install (legacy) section
• Updated Turso telemetry DB to dedicated hub-ctx

v0.3.23 — Clean PyPI page (no dashboard demo)

What changed

• Removed dashboard demo link from README
• Removed dashboard section (Live dashboard image + description)
• PyPI page is now clean: no HuggingFace badge, no demo links, no dashboard section

v0.3.22 — Single-command install + fixed PyPI images

What's new

Zero-friction install

pip install ctx-retriever now auto-wires Claude Code hooks via a .pth file in site-packages. No ctx-install needed.

Bug fixes

• Fixed PyPI cover images — relative paths changed to absolute raw.githubusercontent.com URLs; images now render on pypi.org
• Idle-timeout telemetry flush — 30-min idle detection so single-session users upload data
• Force-overwrite outdated hooks on upgrade — detects pre-telemetry hook files and replaces
• Install-time INSTALL_PING — installs counted in Turso even before first session

v0.3.20 — Auto-activate + funnel telemetry

What's new

Auto-activation on first command

On first run of any ctx command, CTX auto-detects missing hooks and runs ctx-install automatically — no manual second step.

Funnel telemetry

FIRST_USE_PING / FIRST_USE_NO_HOOKS events track install→activation funnel.

Install

pip install ctx-retriever==0.3.20

v0.3.19

schema v1.7: project_type_id + ctx_version + utility_by_qtype

v0.3.18

Auto-upload session stats on session end (opt-out model). No action needed from users.

v0.3.17 — ctx-telemetry send (one-step opt-in)

What's new

ctx-telemetry send — one command to opt-in and upload:

ctx-telemetry send

Previously required two steps (consent grant + upload --send). Now one.

Install prompt also updated to show the simpler command.

v0.3.16 — Beta, telemetry flywheel activated

What's new

• Status: Alpha → Beta — telemetry pipeline live, data flywheel activated
• Stage 2 upload: k-anonymized session_aggregate → Turso (opt-in)
• ctx-install now shows telemetry opt-in prompt after setup
• New project URLs: Documentation, Bug Tracker, Live Demo (HF Space)
• Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
• import os fix in telemetry.py
• Batched Turso inserts (50 rows/call, avoids timeout)
• CTX_TURSO_TOKEN env var override for custom deployments

Install

pip install ctx-retriever==0.3.16 && ctx-install

Opt into anonymous usage data:

ctx-telemetry consent grant
ctx-telemetry upload --send

v0.3.15

feat: CTX dashboard in pip wheel + ctx-dashboard CLI

v0.3.14

Fix: sqlite-vec missing from declared dependencies

Bug: pip install ctx-retriever left new users with a broken CM hook — chat-memory.py hard-imported sqlite_vec at the top level but sqlite-vec was never declared in pyproject.toml dependencies. Any fresh install would crash with ModuleNotFoundError on every Claude Code prompt.

Fix:

• Add sqlite-vec>=0.1.0 to pyproject.toml dependencies (auto-installed with pip)
• Guard import sqlite_vec with try/except + _SQLITE_VEC_OK flag — CM hook degrades to BM25-only on platforms where sqlite-vec fails (old glibc, etc.) instead of crashing

Upgrade: pip install -U ctx-retriever