Name	Name	Last commit message	Last commit date
parent directory ..
api	api
architecture	architecture
moved-readmes	moved-readmes
README.md	README.md
bin-utilities.md	bin-utilities.md
configuration.md	configuration.md
cortex-agent.1	cortex-agent.1
cortex-completions.1	cortex-completions.1
cortex-dev.1	cortex-dev.1
cortex-docs.1	cortex-docs.1
cortex-export.1	cortex-export.1
cortex-git.1	cortex-git.1
cortex-hooks.1	cortex-hooks.1
cortex-install.1	cortex-install.1
cortex-mcp.1	cortex-mcp.1
cortex-notes.1	cortex-notes.1
cortex-rules.1	cortex-rules.1
cortex-skills.1	cortex-skills.1
cortex-skills.md	cortex-skills.md
cortex-status.1	cortex-status.1
cortex-statusline.1	cortex-statusline.1
cortex-suggest.1	cortex-suggest.1
cortex-tmux.1	cortex-tmux.1
cortex-tui.1	cortex-tui.1
cortex-uninstall.1	cortex-uninstall.1
cortex.1	cortex.1
index.md	index.md
scripts-utilities.md	scripts-utilities.md
skill-showcase.md	skill-showcase.md

Name

Last commit message

Last commit date

Manpage Generation

Manpages for cortex are auto-generated from the CLI argparse definitions.

📄 Generated Files

cortex.1 - Main command reference
cortex-tui.1 - TUI subcommand reference
cortex-workflow.1 - Workflow subcommand reference

🔄 Regeneration

Manpages are automatically regenerated:

During installation - just install or ./scripts/deprecated/install.sh
Manual generation - just generate-manpages or python3 scripts/generate-manpages.py
Pre-commit hook - When claude_ctx_py/cli.py is modified (optional)

🔧 Setup Pre-commit Hook

To automatically regenerate manpages when CLI changes:

git config core.hooksPath .githooks

📝 Editing

Do NOT manually edit the .1 files - they will be overwritten.

Instead:

Update CLI help text in claude_ctx_py/cli.py
Modify the generator in scripts/generate-manpages.py
Run just generate-manpages to regenerate

🧪 Testing

View generated manpages:

# After generation
man docs/reference/cortex.1

# After installation
man cortex

📅 Version & Date

Version: Extracted from pyproject.toml
Date: Set to generation date (YYYY-MM-DD format)

FilesExpand file tree

reference

Directory actions

More options