Skip to main content

USAGE

Constant USAGE 

Source
pub const USAGE: &str = "\
Usage: wsb github <command> [options]

The machine's GitHub mirror, in $PRJ/.state. Reads answer from it, brought
current first when due; writes go to GitHub first and the mirror takes GitHub's
answer. The token is the GitHub CLI's login (gh auth token), else GITHUB_TOKEN.

Mirror
  sync [--force]         bring everything every project needs up to date
  status                 where the mirror and the token are, and what is failing

A project's boards (references only; the boards live in the mirror)
  boards                 the boards this project references
  boards add <owner>/<number>...
  boards remove <owner>/<number>...

Issues
  issues [--repo <owner>/<repo>] [--state open|closed|all]
                         this worktree's repositories' issues, newest first

Boards
  project [list]         this project's boards
  project show <board>   one board's fields, and the options of each
  project items <board> [--status <column>] [--where <field>=<value>]... [--archived]
                         the board's cards, by column
  project item <board> <card>
                         one card, whole: its fields and its description
  project add <board> --title <text> [--body <text> | --body-file <path>] [--set <field>=<value>]...
  project add <board> --url <issue or pull request URL> [--set <field>=<value>]...
  project set <board> <card> <field>=<value>...
  project clear <board> <card> <field>...
  project move <board> <card> --after <card> | --top
  project edit <board> <card> [--title <text>] [--body <text> | --body-file <path>]
  project archive <board> <card>, project unarchive <board> <card>
  project remove <board> <card>
  project column add <board> <name> [--field <field>] [--color <COLOR>] [--description <text>]
  project column remove <board> <name> [--field <field>]

A <board> is its number, owner/number, its title or its id. A <card> is its id,
the start of its id, the URL it points at, or its exact title. A name that
matches more than one is refused with every match.

Every command acts on the project the current directory is in; --project <name>
names another. --fresh, on a reading project command, reads GitHub again first
and refuses if it could not. --body-file - reads the body from standard input.

--jsonl makes every line one JSON record: project_board, project_field,
project_item, project_item_removed, board_reference, issue, sync_scope,
sync_problem, sync_summary, status, message, failure.";