v0.2.0

Context CLI v0.2.0

This release brings significant improvements to session recall, code quality, and documentation. The new journal system enables AI-powered analysis of exported sessions, while extensive refactoring consolidates configuration constants and adds thread safety throughout the codebase.

Highlights

• Session Recall & Journal System: Browse, search, and export AI session history with ctx recall, then analyze sessions with ctx journal
• Quick Reference Indexes: DECISIONS.md and LEARNINGS.md now include auto-generated indexes for faster scanning
• Improved CLI Flags: Global --context-dir and --no-color flags, plus required structured flags for decisions and learnings
• Code Quality: Consolidated configuration constants, thread-safe runtime config, and comprehensive test coverage

Features

• Add ctx recall command for browsing AI session history across projects
• Add ctx journal command with site generation for session analysis
• Add quick reference index to DECISIONS.md and LEARNINGS.md with ctx decisions reindex and ctx learnings reindex
• Add global flags: --context-dir to override context directory, --no-color to disable colored output
• Add .contextrc configuration file support for project-level settings
• Add structured attributes to <context-update> XML format for richer metadata
• Require --context, --rationale, --consequences flags for ctx add decision
• Require --context, --lesson, --application flags for ctx add learning
• Add shell completion support via ctx completion (bash, zsh, fish, powershell)

Bug Fixes

• Fix ctx tasks archive to handle nested content correctly
• Fix shell script linter warnings in release and tag scripts

Refactoring

• Consolidate hardcoded strings into config constants (file names, env vars, Claude API types)
• Add thread safety with RWMutex for runtime configuration
• Extract shared helpers to eliminate code duplication (ReindexFile, ScanDirectory)
• Rename internal/templates to internal/tpl
• Use iota for enum-like constants
• Add CRLF-aware newline handling

Documentation

• Add security page with vulnerability reporting guidelines
• Add version history page with release documentation links
• Update demo project with AGENT_PLAYBOOK.md, LEARNINGS.md, and specs examples
• Standardize Go docstrings with Parameters/Returns/Fields sections
• Add CLI output convention (use cmd.Print* instead of fmt.Print*)
• Document ctx completion command and --all-projects flag for recall commands

Dependencies

• Bump golangci/golangci-lint-action from 6 to 9
• Bump actions/setup-go from 5 to 6
• Bump actions/checkout from 4 to 6

---

Full changelog: v0.1.2...v0.2.0

---

Below is autogenerated release notes:

What's Changed

• deps: Bump actions/setup-go from 5 to 6 by @dependabot[bot] in #2
• deps: Bump golangci/golangci-lint-action from 6 to 9 by @dependabot[bot] in #3
• deps: Bump actions/checkout from 4 to 6 by @dependabot[bot] in #1
• Cleanup (part one) before release cut. by @josealekhine in #4
• cleanup before v0.2.0 release cut. by @josealekhine in #5

New Contributors

• @dependabot[bot] made their first contribution in #2
• @josealekhine made their first contribution in #4

Full Changelog: v0.1.2...v0.2.0

v0.1.2

Context CLI v0.1.2

This release improves the out-of-box experience for new users by automatically
configuring Claude Code permissions during ctx init. It also adds a new
Prompting Guide to help users get the most out of AI-assisted workflows.

Highlights

• ctx init now pre-seeds all required permissions for /ctx-* slash commands
• New Prompting Guide documentation with effective prompts for AI sessions
• Added make site-setup, make site, and make site-serve targets

Features

• Automatic permission configuration: ctx init now adds Bash(ctx status:*),
  Bash(ctx agent:*), Bash(ctx add:*), Bash(ctx session:*), Bash(ctx tasks:*),
  and Bash(ctx loop:*) to .claude/settings.local.json. Permissions are merged
  additively to preserve any existing user customizations.

Documentation

• Prompting Guide: New documentation page with effective prompts for working
  with AI assistants in ctx-enabled projects. Covers session start, debugging,
  reflection, and exploration patterns.
• Added Makefile targets for documentation site management (site-setup, site,
  site-serve)

---

Full changelog: v0.1.1...v0.1.2

v0.1.1

Context CLI v0.1.1

This release focuses on stability improvements and better Claude Code integration. Key fixes address JSON settings handling and hook configuration, while new features include a session reflection command and improved documentation.

Highlights

• Fixed JSON unicode escaping issues in settings.local.json
• Corrected Claude Code hook schema keys for proper integration
• Added /ctx-reflect slash command for session reflection
• New comparison documentation page for evaluating Context against alternatives

Features

• Session Reflection Command: New /ctx-reflect slash command helps AI agents reflect on sessions and suggest what context to persist
• Proactive Context Persistence: Added task lifecycle timestamps and improved context persistence workflows
• Template Consolidation: Reorganized Claude templates under internal/templates/ for better maintainability

Bug Fixes

• JSON Unicode Escaping: Fixed issue where settings.local.json incorrectly escaped unicode characters
• Hook Schema Keys: Corrected Claude Code hook configuration to use proper schema keys
• Init Command: Fixed ctx init to insert content after H1 heading instead of appending to end
• Deferred Error Handling: Properly check error return of os.Chdir in defer statements

Documentation

• Added comparison page documenting how Context compares to alternative solutions
• Improved mental model section and formatting in AGENT_PLAYBOOK
• Added learnings about JSON unicode escaping and Claude Code hook schema keys

CI/CD

• Added Dependabot configuration for automated dependency updates
• Set CTX_SKIP_PATH_CHECK=1 for tests to improve CI reliability
• Build golangci-lint from source to support Go 1.25

---

Full changelog: v0.1.0...v0.1.1

v0.1.0

Context CLI v0.1.0

Initial release of the Context CLI (ctx) - a tool for persistent AI context management.

What's New

This is the first stable release of ctx, providing:

• Context Management: Create and maintain .context/ directories with structured markdown files
• AI Integration: Built-in support for Claude Code with hooks and slash commands
• Session Persistence: Automatic session saving and transcript management
• Drift Detection: Track staleness of context files
• Multi-tool Support: Integration guides for Claude Code, Cursor, Aider, Copilot, and Windsurf

Installation

Linux (x86_64)

curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.0/ctx-0.1.0-linux-amd64
chmod +x ctx-0.1.0-linux-amd64
sudo mv ctx-0.1.0-linux-amd64 /usr/local/bin/ctx

Linux (ARM64)

curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.0/ctx-0.1.0-linux-arm64
chmod +x ctx-0.1.0-linux-arm64
sudo mv ctx-0.1.0-linux-arm64 /usr/local/bin/ctx

macOS (Apple Silicon)

curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.0/ctx-0.1.0-darwin-arm64
chmod +x ctx-0.1.0-darwin-arm64
sudo mv ctx-0.1.0-darwin-arm64 /usr/local/bin/ctx

macOS (Intel)

curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.0/ctx-0.1.0-darwin-amd64
chmod +x ctx-0.1.0-darwin-amd64
sudo mv ctx-0.1.0-darwin-amd64 /usr/local/bin/ctx

Windows

Download ctx-0.1.0-windows-amd64.exe or ctx-0.1.0-windows-arm64.exe and add to your PATH.

Verifying Checksums

Each binary has a .sha256 file. Verify with:

curl -LO https://github.com/ActiveMemory/ctx/releases/download/v0.1.0/ctx-0.1.0-linux-amd64.sha256
sha256sum -c ctx-0.1.0-linux-amd64.sha256

Quick Start

# Initialize context in your project
ctx init

# Check context status
ctx status

# Get AI-ready context packet
ctx agent --budget 4000

Documentation

Full documentation available at ctx.ist

Checksums

Each binary has a corresponding .sha256 file for verification.