v1.32.0

[butschster]

Release notes

🎯 Highlights

• 🔬 Research System: New file-based research management with templates, structured entries, and deep MCP integration
• 🔌 Multi-Client MCP Support: Interactive configuration for Claude Desktop, Codex, Cursor, and generic MCP clients
• 🪟 Windows PowerShell Installer: Native installation experience for Windows developers
• 🔄 HTTP + SSE Transport: New transport options with configurable host/port for flexible deployment
• 📊 Generated Contexts Statistics: Automatic statistics tracking in generated context files
• 📝 Markdown Import: Import markdown files with YAML frontmatter as CTX resources and prompts
• 🔧 Variable Resolution: Dynamic path variables for flexible, environment-agnostic configurations

✨ New Features

Research System (#247)

A complete file-based research management system that bridges traditional project management and AI-assisted workflows:

• Template System: Define research structures with customizable categories, entry types, and status workflows
• Plain Text Storage: Everything stored as markdown files with YAML frontmatter - git-friendly and AI-native
• MCP Tools Integration: Full set of MCP tools for Claude to manage researches, create/update entries, and search content
• Flexible Organization: Support for multiple research types (feature discovery, technical investigation, user research, etc.)
• AI-First Workflow: Designed specifically for AI-assisted development and research processes

Example Use Cases:

• Product teams: Customer research and feature discovery
• Development teams: Technical spikes and architecture decisions
• Consulting teams: Client engagement and project tracking
• Research teams: Academic research and data collection

Multi-Client MCP Configuration (#270)

Interactive MCP configuration supporting multiple AI clients:

• Interactive Mode: ctx mcp:config with guided client selection and project setup
• Client Support: Claude Desktop, Codex, Cursor, and Generic configurations
• Strategy Pattern: Extensible architecture for adding new MCP clients
• Client-Specific Instructions: --explain flag shows setup instructions per client
• Flexible Options: Project-scoped vs global configurations, WSL detection on Windows

Usage:

# Interactive mode (recommended)
ctx mcp:config

# Non-interactive with explicit client
ctx mcp:config --client=claude --project-path=/my/project

# Show setup instructions
ctx mcp:config --explain --client=cursor

Windows PowerShell Installer (#260)

Native Windows installation:

• Smart PATH Management: Automatic PATH updates with user confirmation
• Flexible Installation: Default to %LOCALAPPDATA%\ctx or current directory with --CurrentDir
• One-Line Install: powershell -c "& ([ScriptBlock]::Create((irm 'URL'))) -AddToPath"
• Cross-Architecture Support: Auto-detection of x86/x64/ARM64

Variable Resolution in Source Paths (#272)

Enhanced variable system with new predefined path variables:

• New Variables: ${ROOT_PATH}, ${CONFIG_PATH}, ${ENV_PATH}, ${BINARY_PATH}
• Dynamic Paths: Use variables in source paths for environment-agnostic configurations
• Environment Portability: Configurations work across different project locations and team members

Example:

sources:
  - path: "${ROOT_PATH}/src"
  - path: "${CONFIG_PATH}/../docs"

HTTP + SSE Transport Support (#257, #264)

New transport layer with HTTP and Server-Sent Events:

• SSE Transport: ctx mcp:server --sse for event-driven communication
• Configurable Networking: --host and --port options for custom deployments
• CORS & Proxy Middleware: Built-in support for cross-origin requests (feat: add HttpTransportBootloader with CORS and Proxy Middleware configuration #258)

Markdown Import with YAML Frontmatter (#TBD)

Comprehensive support for importing markdown files as CTX resources and prompts:

• Directory Scanning: Recursively process .md and .markdown files from specified directories
• YAML Frontmatter Parsing: Extract metadata including type, title, description, tags, and schemas
• Auto-Detection: Automatically classify files as prompts or resources based on metadata
• AI Tool Integration: Seamless integration with Claude Code, Cursor, and other MCP clients
• Flexible Configuration: Simple format: md parameter in import blocks
• Smart Title Extraction: Priority-based title resolution (frontmatter → headers → filename)
• Backward Compatible: Existing configurations work unchanged (defaults to format: "config")

Use Cases:

• Import existing prompt libraries and documentation directories
• Convert markdown documentation into discoverable MCP resources
• Share team knowledge bases through version-controlled markdown files
• Maintain prompts in familiar markdown format with programmatic access

Example Configuration:

import:
  - type: local
    path: ./docs           # Directory containing .md files
    format: md             # Process as markdown with metadata

Supported File Formats:

---
type: prompt
title: "Code Helper"
description: "Assists with coding tasks"
tags: ["coding", "development"]
schema:
  properties:
    language: { type: string }
---

# Content here
Help me with {{language}} programming.

File Statistics (#250)

Automatic statistics in generated context files:

• Character Counts: Track content size for context window management

✓ Project structure overview [project-structure.md]................................................. (30.9 KB, 481 lines)
✓ Core Interfaces [core/interfaces.md].............................................................. (43.9 KB, 1757 lines)
✓ Changes in the Project [changes.md]............................................................... (178 B, 9 lines)
✓ Source core [sources/loader.md]................................................................... (27.7 KB, 973 lines)
✓ [source] File [sources/file-source.md]............................................................ (23.1 KB, 732 lines)
✓ [source] GitHub [sources/github-source.md]........................................................ (35.7 KB, 1260 lines)
✓ [source] Gitlab [sources/gitlab-source.md]........................................................ (44.2 KB, 1528 lines)
✓ [source] URL [sources/url-source.md].............................................................. (14.6 KB, 448 lines)
✓ [source] Docs [sources/docs-source.md]............................................................ (11.7 KB, 386 lines)
✓ [source] Text [sources/text-source.md]............................................................ (6.2 KB, 226 lines)
! [source] MCP [sources/mcp-source.md]..............................................................
   ✗ Error in FileSource: Some directories or files contain invalid paths: 

Precise Content Replacement Tool (#276)

New MCP tool for safe, surgical file updates:

• ctx:file-replace-content: Find and replace unique text occurrences
• Safety First: Requires exact unique matches to prevent unintended changes
• Better Than Full Rewrites: Reduces token usage and preserves file integrity

🐛 Bug Fixes

• Install Script: Fixed critical issues in installation script (Fix issues in install script #246)
• PHAR Path Handling: Resolved path format issues for config and runtime directories (fix: fixed path for configs and runtime. Dirs now inside binary, not … #254)
• Custom Directories: Implemented custom Directories class that preserves phar:// path format (fix: use custom Directories class that does not break phar:// path format #255)

📦 Installation

Quick Install

macOS/Linux:

curl -fsSL https://raw.githubusercontent.com/context-hub/generator/main/download-latest.sh | bash

Windows (PowerShell):

powershell -c "& ([ScriptBlock]::Create((irm 'https://raw.githubusercontent.com/context-hub/generator/main/download-latest.ps1'))) -AddToPath"

New Contributors

• @0oAstro made their first contribution in feat: Add file statistics to generated markdown files #250
• @savinmikhail made their first contribution in Multi-Client MCP Configuration Support #270

Full Changelog: 1.31.0...1.32.0

---

This discussion was created from the release v1.32.0.