Major additions:
- Add statusline configuration support in wizard and CLI
- Add rules editor (cortex rules edit)
- Add plan viewer with bookmarks, search, and path resolution
- Add docs viewer with tree display, bookmarks, and full-text search
- Add interactive docs TUI browser with markdown rendering
- Integrate bin/scripts utilities into main package structure
New CLI commands:
- cortex dev (validate, manpages)
- cortex file (download, extract-ids)
- cortex uninstall (with dry-run support)
- cortex skills audit (quick/full audits with reporting)
Infrastructure improvements:
- Fix tour state persistence to use ~/.claude/tour-state.json
- Fix TUI memory vault and MCP server keyboard shortcuts
- Update package bundling for codex and all asset directories
- Support bundled docs in installed packages
- Clean integration of utilities (utils/, commands/ structure)
Cleanup:
- Remove obsolete template system
- Delete redundant documentation (AGENT-LOOPS, TESTING, TEST-AUDIT)
- Migrate bin/scripts to proper package structure
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Update plugin.json with postInstall hook and v3.0.0
- Delete outdated marketplace.json (plugins/ consolidated)
- Add scripts/post-install.sh for automatic rule symlinking
- Add scripts/uninstall.sh for cleanup
- Add _find_plugin_root() to installer.py for multi-install support
- Update README with new installation instructions
Users can now install via:
claude install github:NickCrew/claude-cortex
Or with Python CLI:
pip install claude-cortex
cortex install bootstrap --link-rules
Add JSON Schema validation for:
- cortex-config.json: Main CLI/launcher configuration
- skill-rules.json: Keyword-based skill matching rules
- recommendation-rules.json: File pattern-based skill recommendations
- memory-config.json: Memory vault and auto-capture settings
- onboarding-state.json: Wizard completion state
Each config file now includes a $schema reference for editor
autocompletion and validation. Also updates sync script to use
schemas/ directory name.
Remove claude_ctx_py/assets/ from git tracking and make it a build
artifact regenerated by `just bundle-assets`. This eliminates the
confusing dual-copy situation where both repo root and bundled assets
were tracked and had diverged.
Changes:
- Remove claude_ctx_py/assets/ from git (now in .gitignore)
- Add plugins/ to sync script for domain-specific packages
- Make `just build` depend on bundle-assets
- Document asset workflow in CLAUDE.md
- Reorganize agents: promote 5 from inactive, demote 2 to inactive
- Update dependencies.map with comprehensive agent mappings
Build Configuration:
- Update pyproject.toml with new dependencies and entry points
- Update pytest.ini with improved test configuration
- Update justfile with new development tasks
- Update Makefile with build improvements
Scripts:
- Add generate-manpages.py for automatic manpage generation
- Update install.sh with new installation steps
Git Hooks:
- Add .githooks/pre-commit for automatic manpage regeneration
Hooks Examples:
- Add memory_auto_capture.py for automatic memory capture
- Enhance skill_auto_suggester.py with improved recommendations
Project Files:
- Update README.md with new features documentation
- Update CONTRIBUTING.md with updated guidelines
- Update .gitignore with new exclusions
- Add modes/Amphetamine.md behavioral mode
- Update community skills registry
Reorganized the directory by moving files into new subdirectories (e.g., , ).
Updated all internal links across the documentation to reflect the new file structure.
Moved and to .
Updated , , , , and several other documentation files to correct broken links.
Created a placeholder file for .
Created a unified installation system that handles package installation,
shell completions, and manpage setup with a single command.
**New Files:**
1. scripts/install.sh (380 lines)
- Comprehensive installer handling all setup tasks
- Auto-detects shell (bash/zsh/fish) for completions
- Supports multiple installation modes (editable/system-wide)
- Colorized output with clear success/error messages
- Verification step confirms everything works
Features:
- Package installation (editable or system-wide)
- Shell completions (bash/zsh/fish)
- Manpage installation
- Installation verification
- Flexible options (--no-package, --no-completions, etc.)
2. Makefile (94 lines)
- Convenient make targets for common tasks
- Development workflow automation
Targets:
- make install - Full installation
- make install-dev - Development mode installation
- make test - Run test suite
- make test-cov - Tests with coverage
- make type-check - Run mypy on Phase 4 modules
- make lint - Check code formatting
- make clean - Remove build artifacts
- make docs - Start documentation server
- make verify - Check installation status
**Updated:**
- README.md
- Added "Installing the CLI" section with quick install guide
- Documented installation script options
- Added Makefile usage examples
- Updated shell completion instructions (auto-installed now)
- Updated manpage section (auto-installed now)
- Better organization of installation methods
**Removed:**
- scripts/claude-ctx (old bash wrapper)
- scripts/install-claude-ctx.sh (replaced by install.sh)
**Usage:**
Quick install everything:
./scripts/install.sh
Or use make:
make install # Full installation
make help # Show all targets
Installation script options:
./scripts/install.sh --help # Show options
./scripts/install.sh --no-completions # Skip completions
./scripts/install.sh --shell zsh # Specify shell
./scripts/install.sh --system-install # System-wide mode
The installer replaces the previous multi-step manual process with a
single command that handles everything automatically and provides clear
feedback at each step.
Created a complete Unix manual page (docs/claude-ctx.1) documenting all CLI
commands, subcommands, options, and usage patterns. The manpage follows
standard groff format conventions and includes:
**Documentation Coverage:**
- All 9 main commands (status, mode, agent, rules, skills, init, profile, workflow, orchestrate)
- 60+ subcommands with detailed descriptions
- Command-line options and flags
- File locations and directory structure
- Environment variables (CLAUDE_CTX_HOME, CLAUDE_PLUGIN_ROOT)
- Exit codes and error handling
- Comprehensive examples section
**Special Sections:**
- VERSIONING - Semantic versioning support with operators (^, ~, >=, latest)
- ANALYTICS - Metrics tracking and effectiveness scoring
- QUALITY STANDARDS - Community skill validation requirements
- DEPENDENCY MANAGEMENT - Composition system and cycle detection
**Installation:**
- Created install-manpage.sh script for system-wide installation
- Supports macOS and Linux
- Auto-detects man directory (/usr/local/share/man or /usr/share/man)
- Updates man database (mandb/makewhatis)
**Package Integration:**
- Updated pyproject.toml to include manpage in distribution
- Manpage installed to share/man/man1/ on pip install
- Updated README with manpage usage instructions
**Usage:**
- View directly: man docs/claude-ctx.1
- Install system-wide: ./scripts/install-manpage.sh
- Access after install: man claude-ctx
Files:
- docs/claude-ctx.1 (499 lines) - Complete manpage in groff format
- scripts/install-manpage.sh (56 lines) - Installation helper script
- README.md - Added manpage documentation section
- pyproject.toml - Added data-files configuration for manpage
The manpage provides professional Unix-style documentation making claude-ctx
more accessible and discoverable through standard man page system.
Nicholas Ferguson