Output of `cortex dev manpages`. Picks up the three subcommands
shipped earlier in this branch: session-new, session-kill, attach.
No other manpage changed (same-day regen so date stamps are stable;
no new top-level subparsers so pyproject.toml needs no update).
`cortex dev validate-manpages` passes.
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.
Three manpages that are new files (not modifications):
- cortex-completions.1: previously missing (regenerator caught this)
- cortex-notes.1: new command introduced in f29c031 (memory -> notes)
- cortex-suggest.1: new file despite suggest being an existing command
Generated alongside the regeneration in 5c08b6b; split into a separate
commit because these are new files rather than modifications.
The old name collided semantically with the test-review skill (which
is the module-audit tool). The new name makes the distinction clear:
diff-test-audit runs per-commit coverage checks on the current diff;
the test-review skill is for module-level audits.
This is a mechanical rename — all 42 references across skills, docs,
tests, backlog, and sibling scripts are updated. The script's
underlying methodology (LLM reviewer using the shared audit workflow)
is unchanged; narrowing the audit methodology to focus only on
diff-introduced behaviors is a separate concern that needs prompt-
engineering and output evaluation work.
Environment variable names (TEST_REVIEW_PROVIDER, etc.) are
intentionally left unchanged — they are a user-facing API and would
constitute a breaking change if renamed.
Adds a multi-specialist-review entry to both the internal docs
(docs/reference/skill-showcase.md) and the public site
(site/reference/skills.md). Placed under Multi-Agent Coordination Skills
alongside agent-loops, its parent before extraction.
Highlights the user-triggered nature, the five-phase orchestration, the
zero-API-cost deterministic phases, and the Claude-Code-only constraint.
hooks/hooks.json was the Claude Code plugin manifest from when Cortex
was distributed as a plugin. Registration now lives exclusively in
~/.claude/settings.json, managed through the TUI Hooks view. The file
had four internal references remaining (core/hooks.py:314,
tui/dialogs/hooks_manager.py:181, tui/main.py:595, cli.py:125-130),
but all call sites except the CLI check is_file() before invoking
validate_hooks_config_file() and gracefully no-op when missing. The
only surviving impact is that "cortex hooks validate" without a path
argument will error instead of validating a nonexistent default.
docs/reference/moved-readmes/hooks.md was a 425-line plugin-era doc
describing seven hooks that do not exist in hooks/
(implementation-quality-gate.sh, parallel-workflow-enforcer.sh,
safety_pre_tool_guard.py, context_pack_injector.py,
memory_auto_capture.py, changelog_gate.py, plus a referenced
HOOK_DOCUMENTATION.md archive) and omitting the six that do. The
content conflicted with site/guides/hooks.md and no inbound references
pointed at it other than the stub in hooks/README.md, which was
rewritten in the prior commit.
Curated guide to the most non-obvious skills organized by capability:
meta-cognitive, verification, debugging, multi-agent coordination,
ideation, and efficiency. Includes what makes each skill sophisticated
and when to trigger it. Linked from the reference index.
Remove references to non-existent modes/, workflows/, profiles/, scenarios/,
and flags/ directories across 11 documentation files. These described a
planned "three-layer system" that was superseded by the current skills-based
architecture.
Key changes:
- AGENTS.md: update core module tree to match actual codebase
- docs/index.md: fix version (2.0.0 → 3.0.1), remove Mode/Workflow/Flag sections
- docs/guides/hooks.md: replace 7 phantom hooks with 9 actual hooks
- docs/reference/api/index.md: list actual core modules
- docs/reference/architecture/: remove three-layer references, fix paths
- Archive quick-reference.md (entirely phantom content)
- Fix broken modes.html links and stale CLI command references
Remove cortex-workflow references since the command is not implemented
and workflow orchestration is currently handled through composition of
existing commands (agent, skills, review, plan, export, ai).
- Remove workflow subcommand from validation and generation
- Remove cortex-workflow.1 from manpage bundle
- Delete placeholder cortex-workflow.1 manpage file
This keeps the build clean and only bundles manpages for implemented
commands (cortex.1 and cortex-tui.1).
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.
Add comprehensive documentation for all cortex config files:
- cortex-config.json: Main launcher configuration
- memory-config.json: Memory vault settings
- skill-rules.json: Keyword-based skill matching
- recommendation-rules.json: File pattern recommendations
- onboarding-state.json: Wizard completion state
Each section includes schema definition, field descriptions, examples,
and usage instructions. Also adds JSON Schema validation setup for
VS Code and updates settings-files.md with links to the new docs.
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
- Update slash command documentation with delegation protocols
- Add doctor command and design documentation
- Consolidate inactive agents into unified directory
- Add model optimization guide for Opus 4.5
- Update rules and workflow documentation
- Add unit tests for claude refs and slash commands
Move agents-disabled/ and modes-inactive/ into single inactive/
directory structure. Update core modules to parse CLAUDE.md refs
with new path patterns, enhance TUI components, and update docs.
Nicholas Ferguson