sc

# sc - Supernal Coding CLI

Development workflow automation, task management, requirements tracking, and autonomous task execution.

Canonical scope:
- `sc` is for developer/project workflow commands.
- `orch` is for orchestration runtime operations (capacity/spawn/triage/heartbeat/automation).
- Do not assume same-name commands across CLIs are semantic equivalents.

## Installation

```bash
npm install -g @supernalintelligence/supernal-coding
```

## Quick Reference

### Task Management (PRIMARY)
```bash
sc task create "Title" --assignee @me --priority P2
sc task list                         # Your tasks  
sc task list --all                   # All repos
sc task list --status in-progress    # Filter by status
sc task view TASK-123                # View task details
sc task start TASK-123               # Begin work (sets in-progress)
sc task done TASK-123 --notes "..."  # Complete task
sc task next                         # Get next task (ralph mode)
sc task verify TASK-123              # Check evidence (optional)
sc task edit TASK-123                # Edit in $EDITOR

# Session linkage (dashboard only - requires localhost:3006)
sc task link TASK-123                # Link to current session (needs OPENCLAW_SESSION_KEY)
sc task link TASK-123 --session "..."  # Link with explicit session
sc task linked                       # List linked tasks
sc task unlink TASK-123              # Remove link
```

**Storage:** `.supernal/tasks/` (per-repo) or `~/.supernal/tasks/` (global)

**Workflow Guide:** See `docs/TASK_WORKFLOW.md` for how tasks, requirements, features, and specs work together.

### Project Health & Status
```bash
sc health                    # Run health checks
sc monitor                   # Development status dashboard
sc status                    # Alias for monitor
```

### Requirements & Traceability
```bash
sc trace                     # Traceability matrix
sc planning                  # Manage epics, features, requirements, tasks
sc audit...