Skip to content

Latest commit

 

History

History
71 lines (54 loc) · 2.98 KB

fest_list.md

File metadata and controls

71 lines (54 loc) · 2.98 KB

fest list

List festivals by status

Synopsis

List festivals filtered by status.

Works from anywhere - finds the festivals workspace automatically.

STATUS can be: active, ready, planning, parked, ritual, completed, all, dungeon, dungeon/completed, dungeon/archived, dungeon/someday

By default, shows active, ready, planning, parked, and ritual festivals. Use 'fest list all' (or --all) to include completed and dungeon festivals.

Use --watch to refresh the multi-festival status board when festival progress or lifecycle status changes (similar to fest watch, but without cycling). Ctrl+C to quit.

Each festival is annotated with a token count. Counting is bounded by size and time, and --no-tokens skips it entirely.

fest list [status] [flags]

Examples

  fest list                                        # Active, ready, planning, ritual festivals
  fest list active                                 # Only active festivals
  fest list all                                    # Every festival grouped by status
  fest list dungeon/completed                      # Completed festivals in the dungeon
  fest list --filter-project camp                  # Festivals linked to "camp" project
  fest list active --sort progress                 # Active festivals, most complete first
  fest list --since 2026-01-01 --until 2026-02-01  # Created in January 2026
  fest list --json                                 # Output in JSON format
  fest list --no-tokens                            # Skip token counting
  fest list --watch                                # Live multi-festival status board
  fest list active --watch                         # Watch only active festivals

Options

      --all                     include completed and dungeon festivals
      --alpha                   sort alphabetically by name instead of by date
      --filter-project string   filter festivals linked to a project path (substring match)
  -h, --help                    help for list
      --json                    output in JSON format
      --no-tokens               skip token counting for each festival
      --progress                show detailed progress for each festival
      --since string            show festivals created on or after this date (YYYY-MM-DD or RFC3339)
      --sort string             sort by: date|status|progress|name|created|updated
      --status string           filter by status: active|planning|completed|dungeon
      --until string            show festivals created on or before this date (YYYY-MM-DD or RFC3339)
  -w, --watch                   refresh the list when festival progress or lifecycle status changes

Options inherited from parent commands

      --config string   config file (default: ~/.obey/fest/config.json)
      --debug           enable debug logging
      --no-color        disable colored output
      --verbose         enable verbose output

SEE ALSO

  • fest - Festival Methodology CLI - goal-oriented project management for AI agents