Output of `cortex dev manpages`. Surfaces two changes:
1. cortex-tmux.1 picks up the new subcommands shipped in this
branch (say, sessions, snapshot, rename) plus the --cwd flag
on `tmux new` and pane-syntax targeting.
2. cortex-hooks.1 was generated for the first time — the `hooks`
subparser had been live in the CLI for a while but the manpage
wasn't registered as a setuptools data-file, so users who
installed via pip never got `man cortex-hooks`.
The other 17 manpages show date-stamp-only diffs; no content change.
`cortex dev validate-manpages` passes after the pyproject update.
cortex review printed a deprecation notice on every invocation pointing
to cortex suggest --review, which has been the functional replacement.
Matches today's pattern (worktree, ai, file, dev validate).
Retained:
- claude_ctx_py/cmd_review.py — still imported by cmd_suggest.py:439
for the cortex suggest --review code path
- cortex suggest --review with the same flags (--dry-run, --context)
Removed: parser block, handler, dispatch entry, orphaned cortex-review.1
manpage. Regenerated cortex.1 to reflect the shrunk surface.
Top-level surface: 19 -> 18.
Add 'cortex dev validate-manpages' command to validate that installed
manpages are current with CLI definitions. This ensures manpages don't
fall out of sync during development.
- Implements validate_manpages() function in dev_validate_manpages.py
- Compares generated manpages against stored files
- Returns exit code 0 if all current, 1 if any stale
- Integrates into CLI dev subcommands with --verbose and --docs-dir options
- Fixes path resolution in dev_manpages.py to use project root
- Regenerates manpages to match current CLI definitions
This addresses the need for pre-release validation before packaging
or deployment to ensure documentation stays synchronized with code.
Adds a Rich-based wizard that auto-triggers when ~/.cortex doesn't
exist, guiding users through initial configuration including target
directory, shell completions, aliases, and rule symlinking.
- New wizard.py module with WizardConfig dataclass and 7-step flow
- --skip-wizard/--no-init flags and CORTEX_SKIP_WIZARD env var
- Auto-skips in non-interactive environments (CI, pipes)
- 16 unit tests covering detection, config, and error handling
- Add documentation viewer command (cmd_docs.py)
- Enhance CLI with improved completions and subcommands
- Add messages module for user communication
- Improve hooks system in core with better event handling
- Enhance launcher with additional configuration options
- Add TUI screens for improved navigation
- Enhance hooks manager dialog
- Improve watch mode with better file monitoring
- Bundle documentation site for offline viewing
Nicholas Ferguson