# Using Shannon CLI

> Use when starting work with Shannon CLI or need to understand available commands - introduces shannon analyze, wave, do, exec commands, explains when to use each, guides installation and basic workflows

- Skill: `majiayu000/using-shannon-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/using-shannon-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/using-shannon-cli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/using-shannon-cli

---


# 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

```bash
# 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