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

npm install -g @supernalintelligence/supernal-coding

Quick Reference

Task Management (PRIMARY)

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

sc health                    # Run health checks
sc monitor                   # Development status dashboard
sc status                    # Alias for monitor

Requirements & Traceability

sc trace                     # Traceability matrix
sc planning                  # Manage epics, features, requirements, tasks
sc audit                     # Audit features, requirements, tests

Git & Workflow

sc git                       # Git workflow operations
sc git smart                 # Smart commits, branch management
sc workflow                  # Project workflow management

Ralph (Autonomous Loops)

sc ralph                     # Autonomous task execution
sc spec <action> [target]    # Spec file management for ralph loops

Code Quality

sc code <action>             # Code quality and contracts
sc compliance                # HIPAA, SOC 2, ISO 27001 validation
sc security                  # Database security verification

Documentation

sc docs                      # Documentation management
sc search <query>            # Search across all content

System

sc init [dir]                # Initialize project
sc update                    # Check for updates
sc system                    # Config, upgrade, sync, license

Common Patterns