Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Commands

The cargo rpg command is a CLI for manipulating and checking project goals. This section provides a reference describing (some of) the ability commands. You can also try cargo rpg --help to get a summary.

Note that this relies on the gh client, which needs to be installed and configured with a token (for example using gh auth login).

Available Commands

cargo rpg cfp

Sets up a new Call For Proposals (CFP) period. This command automates the process of creating the necessary directory structure, copying template files, and updating both the SUMMARY.md and README.md files.

# Basic usage
cargo rpg cfp <timeframe>

# Options
cargo rpg cfp <timeframe> --force    # Force overwrite without asking for confirmation
cargo rpg cfp <timeframe> --dry-run  # Don't make any changes, just show what would be done

Example:

cargo rpg cfp 2025h2

Note that after running this command, you'll still need to manually:

  1. Prepare and publish a blog post on the Inside Rust blog
  2. Send an email to the all[The Rust Programming Language][].org mailing list

For more details, see the Call for proposals documentation.

cargo rpg csv

Generates CSV reports for analysis and tracking purposes. Currently supports generating champion tracking reports.

# Generate champions report for a milestone
cargo rpg csv champions <milestone>

Example:

cargo rpg csv champions 2025h2

champions subcommand

The champions subcommand generates a CSV report showing the champion assignments for each goal in a milestone. The output includes:

  • Title: The goal title
  • POC(s): Point of contact for the goal
  • Team columns: One column per team that has asks across all goals in the milestone
    • Shows champion name if assigned
    • Shows ! if team has an ask but no champion assigned
    • Shows - if team has no ask for this goal
  • URL: Link to the goal document on GitHub

This report is useful for:

  • Tracking champion coverage across teams
  • Identifying goals that need champion assignments
  • Understanding team involvement across the milestone

The CSV output can be redirected to a file or piped to other tools for further analysis:

cargo rpg csv champions 2025h2 > champions.csv