Releases: fazalur076/Cortex
Release list
v1.2
Cortex (cortex / ctx) v1.2.0 Release Notes
Version: v1.2.0
Release Date: August 13, 2026
This release brings feature-level context explanation, cross-repository feature extraction, local and global scoping across searches and impact analysis, stricter JSON-RPC protocol validation for MCP integrations, and filesystem hash verification for the watcher.
What's New in v1.2.0
Feature Context Explanation (ctx explain )
Added the ctx explain command and feature context engine. Instead of manually grepping through project folders to figure out how a feature is structured, ctx explain aggregates services, controllers, models, components, hooks, and API routes associated with a feature module into a clean, structured overview.
Example usage:
ctx explain authentication
This returns all related backend handlers, database models, frontend components, and route definitions linked to that feature.
Cross-Repository Feature Extractor (ctx feat-extract)
Added support for extracting full feature DAGs across local repositories. ctx feat-extract slices symbol definitions, import dependencies, and line ranges into portable markdown reference files under docs/<feature>-ref.md.
Configurable flags:
-
--max-files <int>: Cap maximum files extracted (default: 15). -
--no-migrations: Skip raw database migration files. -
--no-tests: Omit test files from the generated reference document.
Example:
ctx feat-extract global authentication docs/auth-ref.md --max-files 10
Local and Global Query Scoping (--local / --global / --exclude-current)
You can now explicitly scope symbol lookups, impact analysis, and code searches:
-
--local: Restricts queries strictly to the active workspace. -
--global: Searches across all indexed repositories in~/.cortex/repos/. -
--exclude-current: Searches external local repos while ignoring the active workspace.
Example:
ctx search "authMiddleware" --global --exclude-current
ctx impact UserRole --local
File Watcher Verification (ctx watch --verify)
The real-time kernel file event watcher now supports periodic hash verification using the --verify flag. This periodically reconciles filesystem file hashes against the SQLite index to catch changes during rapid git branch switches (git checkout), rebases, or bulk script edits.
Example:
ctx watch --verify
Strict MCP JSON-RPC Parameter Validation (-32602)
Standardized parameter validation for all native MCP tools (ctx_symbol, ctx_impact, ctx_search, ctx_feature, ctx_feat_extract). Missing required arguments or invalid scope parameters now return standard JSON-RPC RPC error code -32602 Invalid params with descriptive error messages instead of failing silently.
Multi-Platform Production Binaries
Updated pre-compiled release binaries for all target platforms in the release/ directory:
-
macOS: Apple Silicon (ARM64) and Intel (x86_64) packaged in
cortex-macos.zip -
Linux: x86_64 and ARM64 packaged in
cortex-linux.zip -
Windows: x86_64 and ARM64 executables packaged in
cortex-windows.zip
Includes updated automated shell install scripts (install.sh, install-linux.sh, install.ps1).
Upgrade Instructions
To update your local binary build:
macOS
unzip cortex-macos.zip
cd release
bash install.sh
Linux
unzip cortex-linux.zip
cd release
bash install-linux.sh
Windows (PowerShell)
Expand-Archive cortex-windows.zip -DestinationPath release
cd release
.\install.ps1
Verify your index and system status:
ctx doctor
Released under the MIT License. Copyright (c) 2026 Fazalur-Rahman.
v1.1
Zip Archive Download & Extraction Instructions
- macOS (Apple Silicon & Intel)
Download cortex-macos.zip from Releases, then extract and install:
unzip cortex-macos.zip
cd release
bash install.sh
2. Linux (x86_64 & ARM64)
Download cortex-linux.zip from Releases, then extract and install:
unzip cortex-linux.zip
cd release
bash install-linux.sh
3. Windows (PowerShell 5.1 & 7+)
Download cortex-windows.zip from Releases, then extract and install:
Expand-Archive cortex-windows.zip -DestinationPath release
cd release
.\install.ps1
v1.0
Zip Archive Download & Extraction Instructions
- macOS (Apple Silicon & Intel)
Download cortex-macos.zip from Releases, then extract and install:
unzip cortex-macos.zip
cd release
bash install.sh
2. Linux (x86_64 & ARM64)
Download cortex-linux.zip from Releases, then extract and install:
unzip cortex-linux.zip
cd release
bash install-linux.sh
3. Windows (PowerShell 5.1 & 7+)
Download cortex-windows.zip from Releases, then extract and install:
Expand-Archive cortex-windows.zip -DestinationPath release
cd release
.\install.ps1