Skip to content

CLI Commands for Humans

This page covers the most common commands used by human developers for project management and oversight.

Getting Started

Initialize a New Project

s9 init

This interactive wizard will: - Create the .opencode/ directory structure - Initialize the SQLite database - Populate persona names - Render templates and configuration files

View Project Status

s9 dashboard

Shows an overview including: - Active missions and personas - Task summary by status - Epic progress - Recent activity

Filter by role or epic:

s9 dashboard --role Operator
s9 dashboard --epic EPC-H-0001

Task Management

Create Tasks

s9 task create \
  --role Operator \
  --priority HIGH \
  --title "Implement rate limiting" \
  --description "Add rate limiting to API endpoints"

List Tasks

s9 task list                    # All tasks
s9 task list --role Operator    # Filter by role
s9 task list --status TODO      # Filter by status

Search Tasks

s9 task search "rate limiting"

Get Task Suggestions

s9 task next                    # Suggest next tasks to work on
s9 task next --role Operator    # Suggest for specific role

Generate Reports

s9 task report                  # Summary report of all tasks

Mission Management

List Missions

s9 mission list                 # All missions
s9 mission list --active-only   # Only active missions
s9 mission list --role Operator # Filter by role

View Mission Details

s9 mission show 42

Generate Mission Summary

s9 mission summary 42

Shows: - Files changed since mission start - Commits made (filtered by persona) - Tasks claimed and their status

List OpenCode Sessions

s9 mission list-opencode-sessions

Helpful for finding active OpenCode sessions for this project.

Review Management

List Reviews

s9 review list                  # All reviews
s9 review list --status pending # Only pending reviews

View Review Details

s9 review show 5

Approve or Reject Reviews

s9 review approve 5
s9 review reject 5 --reason "Needs more test coverage"

Show Blocked Tasks

s9 review blocked

Shows all tasks that are blocked by pending reviews.

Epic Management

Create an Epic

s9 epic create \
  --title "User Authentication System" \
  --priority HIGH \
  --description "Complete authentication implementation"

List Epics

s9 epic list
s9 epic list --status UNDERWAY

View Epic Details

s9 epic show EPC-H-0001

Abort an Epic

s9 epic abort EPC-H-0001

This will abort the epic and all its linked tasks.

Architecture Decisions (ADRs)

Create an ADR

s9 adr create \
  --title "Use PostgreSQL for production database" \
  --status accepted

List ADRs

s9 adr list
s9 adr list --status accepted

View ADR Details

s9 adr show 3

Release Management

Generate Changelog

s9 changelog

Generates a changelog from completed tasks since the last release.

Utilities

Health Checks

s9 doctor

Runs health checks and validates data integrity.

Launch Agent

s9 summon operator              # Launch OpenCode with Operator role
s9 summon operator --auto-assign # Auto-assign top priority task

Reset Project (Dangerous!)

s9 reset

Resets all project data. Use with extreme caution!

JSON Output

Most commands support --json output for scripting:

s9 task list --json
s9 mission list --json
s9 dashboard --json

Next Steps