Using Shannon CLI

Overview

Shannon CLI provides programmatic access to Shannon Framework with added intelligence (caching, analytics, cost optimization, context awareness).

Core Commands

shannon analyze - Analyze specifications

• When: Have a spec/requirements document
• Output: 8D complexity, domains, phase plan
• Example: shannon analyze project_spec.md

shannon wave - Multi-agent wave execution

• When: Implementing from analyzed spec
• Uses: Shannon Framework wave-orchestration
• Example: shannon wave "implement auth system"

shannon do - Execute tasks (V5)

• When: Create files, implement features, fix bugs
• Uses: Shannon Framework exec skill
• Example: shannon do "create REST API with users"

shannon exec - Autonomous execution (V3.5)

• When: Need validation + git automation
• Uses: CompleteExecutor with 3-tier validation
• Example: shannon exec "add tests for API"

Quick Start

# Install
pip install shannon-cli

# Analyze a spec
shannon analyze spec.md

# Execute a task
shannon do "create hello.py"

# With real-time dashboard
shannon do "create app" --dashboard

Command Selection

Need	Use
Analyze requirements	shannon analyze
Implement from spec	shannon wave
Create files/features	shannon do
With validation/git	shannon exec

Features

• Caching: Automatic (7-30 day TTL)
• Cost Optimization: Auto model selection
• Analytics: Session tracking in SQLite
• Context: Project-aware analysis (after onboarding)
• Dashboard: Real-time execution monitoring