Commit Graph

28 Commits

Author SHA1 Message Date
Nick Ferguson a5985a3239 docs(reference): add configuration reference guide
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.
2026-01-27 14:03:21 -05:00
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
Nicholas Ferguson 09abf6e5ed feat(install): add bootstrap command to initialize ~/.cortex
- Add `cortex install bootstrap` command to copy bundled assets to ~/.cortex
- Creates rules/, flags/, modes/, templates/ directories
- Generates default cortex-config.json and FLAGS.md
- Copy plugins/ directory to bundled assets for packaging
- Update README with bootstrap instructions in installation flow

This fixes the issue where fresh package installs couldn't find assets
or generate configuration files.
2026-01-16 11:23:02 -05:00
Nicholas Ferguson 6a1541032f docs: update documentation and add new plugins
- Update installation and hooks documentation
- Add documentation viewer guide
- Add parallel workflow enforcer guide
- Update watch mode and memory guides
- Add beads issue tracking configuration
- Add marketplace plugin configuration
- Add new plugin templates (accessibility, cognitive, frontend, ux)
- Update agents with improved prompts
- Update build configuration and manifest
2026-01-15 17:02:54 -05:00
Nicholas Ferguson ec0a1b766a feat(core): enhance CLI, TUI, and watch mode functionality
- 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
2026-01-15 17:02:54 -05:00
Nicholas Ferguson ccaa7e879e feat: support persistent claude args 2026-01-08 10:24:09 -05:00
Nicholas Ferguson db0d2c8210 chore: bump version to 2.0.0 2026-01-07 19:21:37 -05:00
Nicholas Ferguson 0f9644b5c1 chore: rename claude-ctx to cortex 2026-01-07 19:21:19 -05:00
Nicholas Ferguson 845de05c94 docs(hooks): add hooks.json pointer 2026-01-07 19:20:22 -05:00
Nicholas Ferguson 19216f8c53 docs(hooks): move examples to hooks.json 2026-01-07 19:20:22 -05:00
Nicholas Ferguson 473a34ae8e feat(tui): add vi-style paging bindings 2026-01-07 19:20:22 -05:00
Nicholas Ferguson 605e7ee400 docs(install): document cli post-install flow 2026-01-07 19:20:22 -05:00
Nicholas Ferguson c621148d1d feat(install): add CLI post-install helpers 2026-01-07 19:20:22 -05:00
Nicholas Ferguson 00bb9c48a6 fix: unblock ci checks 2025-12-31 17:17:56 -05:00
Nicholas Ferguson 505754655c chore: version 1.6.0 2025-12-31 00:33:15 -05:00
Nicholas Ferguson b6b823a32e feat(agents): add 6 cookbook-inspired agents and harden memory security 2025-12-29 13:13:31 -05:00
Nicholas Ferguson 5b1b097465 wip 2025-12-29 13:13:31 -05:00
nferguson_a10 a9e4f836d2 wip 2025-12-20 02:49:52 -05:00
nferguson_a10 986438ac63 wip 2025-12-19 23:20:26 -05:00
nferguson_a10 32b2744e62 docs: add AI guides, plans, and update screenshots
Documentation:
- Add AI guides: LLM_INTELLIGENCE_GUIDE.md, LLM_QUICK_REFERENCE.md
- Add implementation docs: AI_IMPLEMENTATION_SUMMARY.md, AI_INTELLIGENCE.md
- Add planning docs: SEQUENTIAL_EXECUTION_PLAN.md, NEXT_ACTIONS.md
- Add progress docs: DAY1_COMPLETE.md, WEEK0_SUMMARY.md, MODEL_OPTIMIZATION.md
- Add copy-definition-feature.md for TUI copy functionality
- Add manpage-automation.md documenting auto-generation
- Add reference/README.md for manpage documentation

Screenshots:
- Add new screenshots: assets, backups, hooks, memory, skills, wizard series
- Update existing screenshots with improved visuals
- Remove deprecated screenshots: orchestration.png, overview-1.png, overview-2.png

Updates:
- Update TUI guides and entity documentation
- Update presentations with new features
- Update tutorials for new functionality
- Regenerate manpages reflecting CLI changes
2025-12-10 14:48:19 -05:00
nferguson_a10 ab9b98d931 feat(cli): add AI commands and enhance core functionality
- Add new CLI commands for AI features:
  - Memory vault commands
  - Asset management commands
  - Hook management commands
  - AI intelligence commands

- Enhance analytics.py with improved metrics collection
- Refactor skill_recommender.py for better recommendations
- Update shell_integration.py with new integration points
- Improve watch.py with enhanced file monitoring
- Minor updates to core/base.py, context_export.py, profiles.py
2025-12-10 14:47:29 -05:00
nferguson_a10 1ad6700745 feat: major updates to commands, docs, and inactive agent consolidation
- 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
2025-11-26 01:24:36 -05:00
nferguson_a10 1f47e2aac2 refactor: consolidate inactive contexts into unified directory
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.
2025-11-20 11:13:43 -05:00
nferguson_a10 2cf70c9149 Revert "docs: focus GH Pages on guides and reference"
This reverts commit 34f4857ede.
2025-11-15 12:24:10 -05:00
nferguson_a10 34f4857ede docs: focus GH Pages on guides and reference 2025-11-15 12:19:07 -05:00
nferguson_a10 f157ea1c06 chore: update CLI, docs, and misc improvements
Update CLI and core modules:
- Add git commit rules reference to RULES.md
- Update workflow-rules.md with git standards
- Enhance CLI help output formatting
- Add workflow subcommand support
- Update agents.py with minor improvements

Add new manpages:
- claude-ctx-tui.1 for TUI reference
- claude-ctx-workflow.1 for workflow commands
- Update claude-ctx.1 main manpage

Documentation updates:
- Update quality-improvements.md
- Sync _site generated files
- Update skill metadata (internal-comms, skill-creator, webapp-testing)

Build and installation:
- Update Makefile targets
- Improve install-manpage.sh script
2025-11-12 18:13:40 -05:00
nferguson_a10 b808b0fec6 feat(docs): add comprehensive architecture documentation system
Add complete visual documentation for the three-layer automation system
(Commands → Modes → Workflows → Execution) with installation automation.

New Documentation:
- architecture-diagrams.md: 10+ Mermaid diagrams showing system flows
- quick-reference.md: One-page cheat sheet for daily development
- VISUAL_SUMMARY.txt: ASCII art diagram for terminal viewing
- DIAGRAMS_README.md: Guide for using and maintaining diagrams
- WHATS_NEW.md: Comprehensive changelog of recent additions

Packaging Configuration:
- MANIFEST.in: Ensures docs included in source distribution
- pyproject.toml: Adds package-data and data-files sections
- post-install-docs.sh: Auto-installs docs to ~/.claude/docs/
- install.sh: Calls post-install script after package installation

System Statistics:
- 43 slash commands across 16 namespaces
- 8 behavioral modes (4 new: Brainstorm, Deep_Analysis, Quality_Focus, Token_Efficient)
- 9 multi-step workflows (5 new: refactoring, api-design, technical-debt, architecture-review, onboarding)
- 25+ specialized agents
- 3 MCP servers (Codanna, Context7, Sequential)

Installation: Documentation automatically copied to ~/.claude/docs/ on install
Access: Via /docs:diagrams command or cat ~/.claude/docs/VISUAL_SUMMARY.txt
2025-11-11 19:45:58 -05:00
Nicholas Ferguson 815f583988 Docs: Reorganize documentation and fix internal links
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 .
2025-11-09 13:54:27 -05:00