[FEATURE] Enhance cortex demo - Interactive tutorial with real commands

[ShreeJejurikar]

Title

Enhance cortex demo - Interactive Tutorial with Real Commands

Description

The current cortex demo is minimal and doesn't effectively showcase Cortex's capabilities. It only shows hardware detection and runs for ~5 seconds, which doesn't help users understand how to use Cortex.

Current Demo Problems

• ❌ Only shows hardware detection (no actual Cortex features)
• ❌ Non-interactive (just displays text and exits)
• ❌ Doesn't teach users how to use commands
• ❌ Takes only 5 seconds (not comprehensive)
• ❌ Not investor/user-ready

Proposed Solution

Create an interactive tutorial demo (~5 minutes) where users:

• Type real Cortex commands themselves (builds muscle memory)
• Learn by doing, not just reading
• See all major features in action
• Understand the value proposition

Features to Showcase

1. Planning & Safety 🔒

Highlight that Cortex shows the plan before executing:

$ cortex install "docker nodejs"

 CX  ⠋ Understanding request...
 CX  │ Planning installation...

Generated commands:
  1. sudo apt update
  2. sudo apt install -y docker.io
  3. sudo apt install -y nodejs

To execute these commands, run with --execute flag

Key Point: Transparency and safety - users see what will happen first.

2. Hardware Awareness 🔍

Demo how Cortex checks compatibility:

• For AMD GPU users: Show it detecting AMD and suggesting ROCm instead of CUDA
• For NVIDIA GPU users: Show optimized CUDA installation
• Prevent users from installing incompatible software

3. Natural Language AI 🤖

$ cortex ask "I need tools for Python web development"
# Shows intelligent recommendations based on user intent

4. Package Name Intelligence 💡

$ cortex install nodejs
# Works! Even though it's often called 'node' - Cortex understands variations

5. Smart Stacks 📚

$ cortex stack --list
# Shows: ml, ml-cpu, webdev, devops, data

$ cortex stack webdev
# Installs entire web development environment in one command

Implementation Details

Interactive Features

• Fake Shell: Users type commands (with hint and skip options)
• Validation: Accepts close-enough commands (learning-friendly)
• Real Syntax: Teaches actual working Cortex commands
• CX Branding: Uses real CX │ visual style

Visual Consistency

Match the actual Cortex output style:

 CX  ⠋ Understanding request...
 CX  │ Planning installation...
 CX  ✓ Plan ready

Demo Flow (~5 minutes)

1. Intro (30s): What Cortex does + comparison table
2. Smart Install (90s): Install packages, show planning
3. AI Features (90s): Natural language queries
4. Smart Stacks (90s): Pre-configured bundles
5. Conclusion (30s): Next steps

Comparison Table

Show clear differentiation:

Feature	Traditional (apt/brew)	Cortex
Search	Exact string match	Semantic/Intent based
Errors	Cryptic 'Exit Code 1'	AI-explained & Auto-fixed
Hardware Aware	Installs anything	Checks compatibility first
Stacks	Manual script creation	Natural language bundles
Safety	Manual snapshots	Automatic AI rollbacks
Multi-Manager	Choose apt/brew/npm	One command, all managers

Benefits

For Users

• Learn Cortex by actually using it
• Understand key features quickly
• Build muscle memory for commands
• See value proposition clearly

For Investors

• Professional, polished demo
• Shows unique differentiators
• Demonstrates AI capabilities
• Clear competitive advantages

For Contributors

• Modular section-based design
• Easy to add new demo sections
• Well-documented code
• Reusable components

Technical Requirements

Dependencies

• rich (already in project) - for beautiful terminal output
• No new dependencies needed

Files to Modify

• cortex/demo.py - Complete rewrite with new interactive framework

Backward Compatibility

• Keep same entry point: cortex demo
• No breaking changes to CLI

Testing Checklist

• Demo runs without errors
• All commands use correct syntax
• User can type commands interactively
• hint and skip commands work
• Ctrl+C exits gracefully
• Visual output matches real Cortex
• Hardware detection works correctly
• Takes ~5 minutes to complete
• All sections teach real, working commands

Success Criteria

• Users understand how to use Cortex after demo
• Demo is engaging and interactive
• Shows all major Cortex features
• Professional enough for investor demos
• Teaches correct command syntax
• Highlights key differentiators

Additional Context

Current demo output:

🚀 Cortex One-Command Investor Demo
🔍 Scanning system hardware...
✔ CPU: AMD Ryzen 5
✔ RAM: 27.3 GB
✔ GPU: NVIDIA GA107M
🤖 Model Recommendations:
- LLaMA-3-8B → Optimized for your GPU
✅ Demo Complete

This doesn't teach users anything about using Cortex!

[ShreeJejurikar]

working on this - effiti