RCPond Commands

rcpond

Usage:

rcpond [OPTIONS] COMMAND [ARGS]...

Options:

  --version                       Show the version and exit.
  --env-file TEXT                 Path to a .env config file.
  --llm-chat-completions-url TEXT
                                  LLM API endpoint URL.
  --llm-api-key TEXT              LLM API key.
  --llm-model TEXT                LLM model identifier.
  --servicenow-token TEXT         ServiceNow API token (static auth).
  --servicenow-url TEXT           ServiceNow API base URL.
  --servicenow-web-url TEXT       ServiceNow Web UI base URL.
  --servicenow-client-id TEXT     ServiceNow OAuth client ID.
  --servicenow-client-secret TEXT
                                  ServiceNow OAuth client secret.
  --rules-path TEXT               Path to the rules file.
  --system-prompt-template-path TEXT
                                  Path to the system prompt template.
  --email-templates-dir TEXT      Path to the email templates directory.
  --install-completion            Install completion for the current shell.
  --show-completion               Show completion for the current shell, to
                                  copy it or customize the installation.

browse-ticket

Opens a ticket in your default the browser (e.g. RES0001234).

Usage:

rcpond browse-ticket [OPTIONS] TICKET_NUMBER

Options:

  TICKET_NUMBER  [required]

display-all

Display all unassigned tickets from ServiceNow.

Usage:

rcpond display-all [OPTIONS]

Options:

  --long-list / --no-long-list  [default: no-long-list]

display-ticket

Display the details of a specific ticket (e.g. RES0001234).

Usage:

rcpond display-ticket [OPTIONS] TICKET_NUMBER

Options:

  TICKET_NUMBER  [required]

evaluate-all

Evaluate LLM performance against a directory of pre-downloaded HTML tickets.

The output filename is derived from the configured LLM model name and the number of runs, e.g. gpt-4o_3runs.json.

Usage:

rcpond evaluate-all [OPTIONS] IN_DIR OUT_DIR

Options:

  IN_DIR              Directory of pre-downloaded HTML ticket files.
                      [required]
  OUT_DIR             Directory to write the JSON results file.  [required]
  --num-runs INTEGER  Number of LLM runs per ticket (for majority-vote
                      analysis).  [default: 1]

login

Authorise rcpond with ServiceNow via OAuth (browser-based flow).

Opens a browser, completes the Authorization Code + PKCE flow, and caches the resulting tokens. Subsequent commands will use the cached token automatically without prompting again.

Usage:

rcpond login [OPTIONS]

process-all

Review all unassigned tickets via the LLM.

Usage:

rcpond process-all [OPTIONS]

Options:

  --dry-run / --no-dry-run        [default: no-dry-run]
  --reply-mode [cautious|default|always]
                                  [default: default]
  --yes-i-am-sure                 Confirm processing all unassigned tickets.

process-next

Review an arbitrarily selected unassigned ticket via the LLM.

Usage:

rcpond process-next [OPTIONS]

Options:

  --dry-run / --no-dry-run        [default: no-dry-run]
  --reply-mode [cautious|default|always]
                                  Controls when to skip a ticket based on
                                  prior rcpond activity. 'default': skip if
                                  rcpond's comment or work note is the most
                                  recent activity (re-engages after human
                                  follow-ups). 'cautious': skip if rcpond has
                                  ever posted on the ticket. 'always': never
                                  skip.  [default: default]

process-ticket

Review a specific ticket (e.g. RES0001234) via the LLM.

Usage:

rcpond process-ticket [OPTIONS] TICKET_NUMBER

Options:

  TICKET_NUMBER                   [required]
  --dry-run / --no-dry-run        [default: no-dry-run]
  --reply-mode [cautious|default|always]
                                  Controls when to skip a ticket based on
                                  prior rcpond activity. 'default': skip if
                                  rcpond's comment or work note is the most
                                  recent activity (re-engages after human
                                  follow-ups). 'cautious': skip if rcpond has
                                  ever posted on the ticket. 'always': never
                                  skip.  [default: default]

whoami

Show the identity of the currently authenticated OAuth user.

Usage:

rcpond whoami [OPTIONS]