claude-configs/skills/paper-dynasty/reference/cli-reference.md
Cal Corum 8a1d15911f Initial commit: Claude Code configuration backup
Version control Claude Code configuration including:
- Global instructions (CLAUDE.md)
- User settings (settings.json)
- Custom agents (architect, designer, engineer, etc.)
- Custom skills (create-skill templates and workflows)

Excludes session data, secrets, cache, and temporary files per .gitignore.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 16:34:21 -06:00

4.3 KiB

Paper Dynasty CLI Reference

Load this when: You need the full CLI command reference for paperdomo or pd-cards.


paperdomo CLI

The cli.py provides a command-line interface for common operations.

Shell Alias: paperdomo (defined in ~/.bashrc)

Claude Code Note: The alias is not available in non-interactive shells. Use the full path:

python ~/.claude/skills/paper-dynasty/cli.py <command>

Commands

# Status & Health
python ~/.claude/skills/paper-dynasty/cli.py status    # Packs opened today summary
python ~/.claude/skills/paper-dynasty/cli.py health    # API health check

# Team Operations
paperdomo team list [--season N]              # List teams
paperdomo team get SKB                        # Get team details
paperdomo team cards SKB                      # List team's cards

# Pack Operations
paperdomo pack list [--team SKB] [--opened/--unopened]  # List packs
paperdomo pack today                          # Packs opened today analytics
paperdomo pack distribute --num 10            # Distribute packs to all teams
paperdomo pack distribute --num 11 --exclude CAR  # With exclusions

# Gauntlet Operations
paperdomo gauntlet list [--event-id 8] [--active]  # List gauntlet runs
paperdomo gauntlet teams [--active]           # List gauntlet teams
paperdomo gauntlet cleanup Gauntlet-SKB --event-id 8 --yes  # Cleanup team

# Player Operations
paperdomo player get 12345                    # Get player by ID
paperdomo player list [--rarity "Hall of Fame"] [--cardset 27]  # List players

Global Options

--env prod|dev    # Environment (default: prod)
--json            # Output as JSON
--verbose / -v    # Show API request details
--yes / -y        # Skip confirmation for destructive operations

pd-cards CLI

The card creation CLI for retrosheet processing, scouting, custom cards, and S3 uploads.

Location: /mnt/NV2/Development/paper-dynasty/card-creation

Custom Cards

pd-cards custom list                              # List profiles
pd-cards custom preview <name>                    # Preview ratings
pd-cards custom submit <name>                     # Submit to DB
pd-cards custom new -n "Name" -t batter -h L      # New template

Scouting Reports

pd-cards scouting all -c 27                       # All reports
pd-cards scouting batters -c 27 -c 29             # Batters only
pd-cards scouting pitchers -c 27                  # Pitchers only

Retrosheet Processing

pd-cards retrosheet process 2005 -c 27 -d Live    # Full season
pd-cards retrosheet validate 27                   # Check positions
pd-cards retrosheet arms 2005 -e events.csv       # OF arm ratings
pd-cards retrosheet defense 2005 --output "dir/"  # Fetch defense stats

Retrosheet Flags:

  • --end YYYYMMDD - End date for data processing
  • --start YYYYMMDD - Start date for data processing
  • --season-pct FLOAT - Season percentage (0.0-1.0)
  • --cardset-id, -c INT - Target cardset ID
  • --description, -d TEXT - "Live" or "Month PotM"
  • --dry-run, -n - Preview without database changes
  • --last-week-ratio FLOAT - Recency bias for last week
  • --last-twoweeks-ratio FLOAT - Recency bias for last 2 weeks
  • --last-month-ratio FLOAT - Recency bias for last month

S3 Uploads

pd-cards upload s3 -c "2005 Live"                 # Upload to S3
pd-cards upload s3 -c "2005 Live" --limit 10      # Test with limit
pd-cards upload refresh -c "2005 Live"            # Regenerate
pd-cards upload check -c "2005 Live"              # Validate only

Upload Flags:

  • --cardset, -c: Cardset name (required)
  • --start-id: Resume from player ID
  • --limit, -l: Max cards to process
  • --no-upload: Validate only
  • --skip-batters/--skip-pitchers: Skip card types
  • --dry-run, -n: Preview mode

Live Series

pd-cards live-series update -c "2025 Season" -g 81
pd-cards live-series status

Scripts Directory

Location: ~/.claude/skills/paper-dynasty/scripts/

# Gauntlet cleanup
python gauntlet_cleanup.py list --event-id 8 --active-only
python gauntlet_cleanup.py wipe --team-abbrev Gauntlet-SKB --event-id 8

# Pack distribution
DATABASE=prod python distribute_packs.py --num-packs 10
DATABASE=prod python distribute_packs.py --num-packs 11 --exclude-team-abbrev CAR

# Validation
python validate_database.py