Executing Tasks with shannon do

Overview

shannon do executes development tasks by invoking Shannon Framework exec skill, wrapped with V3 intelligence (cache, analytics, cost optimization).

When to Use

Use shannon do for:

• Creating files: "create hello.py"
• Implementing features: "add authentication to API"
• Fixing bugs: "fix login validation error"
• Multi-file tasks: "create models.py, views.py, tests.py"

Don't use for:

• Analyzing specs → shannon analyze
• Autonomous with git automation → shannon exec
• Wave orchestration → shannon wave

Basic Usage

# Simple task
shannon do "create calculator.py with add and multiply"

# Complex application
shannon do "create Flask API with user auth, posts CRUD, SQLite database"

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

Dashboard Mode

Start services once:

# Terminal 1: WebSocket server
python -m shannon.server.app

# Terminal 2: Dashboard UI
cd dashboard && npm run dev

Then use --dashboard:

shannon do "create authentication system" --dashboard
# Open browser: http://localhost:5173

Shows real-time: task progress, files created, validation status, agents.

vs Other Commands

| Need | Use | |------|-----| | Create code | shannon do | | Analyze spec | shannon analyze | | With git commits | shannon exec | | Multi-agent waves | shannon wave |

Caching

Automatic via UnifiedOrchestrator:

• First run: Full execution
• Check cache: shannon cache stats
• Clear: shannon cache clear