Magic Context ships three npm packages from this repo (@cortexkit/magic-context, @cortexkit/opencode-magic-context, @cortexkit/pi-magic-context) and a Tauri dashboard. All three plugin packages share a single version line and ship together. The dashboard tracks its own dashboard-vX.Y.Z tag line.
Full per-release notes live in GitHub Releases — that's the canonical, user-facing changelog:
- Plugin/CLI releases: https://github.com/cortexkit/magic-context/releases (filtered to
v0.*tags) - Dashboard releases: same page, filtered to
dashboard-v0.*tags
This file exists as a quick navigation map. Working drafts that became those release notes are kept under .alfonso/release-notes/ for reference.
This project uses Semantic Versioning. While the public surface is pre-1.0:
MINORbumps (0.21.0→0.22.0) carry user-visible feature additions or breaking config migrations.PATCHbumps (0.21.6→0.21.7) carry bug fixes and small enhancements that don't change config shape or break existing setups.- Migrations that change config shape always ship with an in-memory shim so existing configs keep working until you run
doctorto rewrite them on disk.
The most recent release line. Notable themes:
- 0.21.7 — Compressor cross-process safety (fixes GH #91), unified agent disable semantics, startup release announcements, auto-search ignores plugin-internal messages.
- 0.21.6 — Hidden subagent permission lock-down, TUI execute-threshold display,
doctor --issue64KB cap. - 0.21.5 — Pi audit fixes wave 1.
- 0.21.4 — Issue #85 emergency-recovery loop fix, compaction markers graduated from experimental.
- 0.21.2 — Pi reference-identity boundary resolution, Pi subagent spawning.
- 0.21.1 — Pi parity sweep (44 audit findings), Pi multi-turn RPC harness, key-files plan v6 implementation.
- 0.21.0 — Sticky-injection multi-anchor persistence, per-project embedding resolution, project-local historian artifacts.
- Boundary-execution v8 (defer execute decisions out of mid-turn passes), short-context overflow recovery, Pi audit fixes batch.
- Deferred compaction-marker movement, JSONC parser resilience, doctor migration framework.
- OpenCode fallback-chain support, dreamer circuit breaker, structured failure reporting.
- Tag-owner composite identity overhaul (fixed cross-turn callID collisions corrupting conversation tags), schema migration v10, runtime-detected SQLite backend selector.
- Unified
@cortexkit/magic-contextCLI replacing per-plugin bins, harness adapters for OpenCode and Pi, doctor/setup/migrate flows, ElectronnativeBindingfor OpenCode Desktop.
See GitHub Releases. Older lines are kept for archival reference but should not be used — upgrade with npx @cortexkit/magic-context@latest doctor --force to refresh OpenCode's cached plugin.