Files
Nicholas Ferguson 570ae0fbd1 feat(cli): add first-run wizard for interactive setup
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
2026-01-17 02:17:24 -05:00

126 lines
2.0 KiB
Groff

.TH CORTEX 1 "2026-01-17" "cortex 2.0.0" "User Commands"
.SH NAME
cortex \- Python implementation of cortex list and status commands
.SH SYNOPSIS
.B cortex
[
B-h
R |
B--help
R]
.br
.B cortex
ICOMMAND
R [
ISUBCOMMAND
R] [
IARGS
R...]
.SH DESCRIPTION
.B cortex
is Python implementation of cortex list and status commands
.SH COMMANDS
Available commands:
.TP
.B mode
Mode commands
.TP
.B agent
Agent commands
.TP
.B rules
Rule commands
.TP
.B principles
Principles snippet commands
.TP
.B prompts
Prompt library commands
.TP
.B hooks
Hook commands
.TP
.B skills
Skill commands
.TP
.B mcp
MCP server commands
.TP
.B init
Initialization commands
.TP
.B profile
Profile commands
.TP
.B workflow
Workflow commands
.TP
.B worktree
Git worktree management commands
.TP
.B orchestrate
Scenario orchestration commands
.TP
.B orch
Mode commands
.TP
.B config
Show the current Cortex launcher configuration
.TP
.B status
Show overall status
.TP
.B statusline
Render Claude Code status line
.TP
.B start
Launch Claude Code with Cortex configuration
.TP
.B claude
Alias for 'start'
.TP
.B tui
Launch interactive TUI for agent management
.TP
.B ai
AI assistant commands
.TP
.B export
Export context commands
.TP
.B completion
Generate shell completion scripts
.TP
.B install
Install CLI integrations and optional extras
.TP
.B docs
Documentation viewer
.TP
.B doctor
Diagnose and fix context issues
.TP
.B memory
Memory capture commands for persistent knowledge storage
.TP
.B setup
Setup and migration commands
.TP
.SH OPTIONS
.TP
.B \-h, \-\-help
Show help message and exit
.SH ENVIRONMENT
.TP
.B CLAUDE_PLUGIN_ROOT
Override for context directory (set automatically by Claude Code when running plugin commands)
.SH FILES
.TP
.B ~/.claude/
Default context directory containing agents, modes, rules, and other configuration
.SH SEE ALSO
.BR cortex-tui (1),
.BR cortex-workflow (1)
.SH AUTHORS
Nicholas Ferguson <ncf423@gmail.com>