RHDH Docs Workflow

Workflow automation for the RHDH documentation team. Content lives in the content repository.

Setup

1. Fork and clone this repository.
2. Install the GitHub CLI and run gh auth login.
3. Create a Jira API token — use a personal API token (not OAuth or PAT). The jirha CLI uses HTTP Basic authentication with your email and this token.
4. Copy .env.example to .env and set JIRA_API_TOKEN and JIRA_EMAIL.
5. Run bash scripts/setup.sh.
6. (Optional) Run bash scripts/setup.sh --global to make jirha available to Claude in all your projects.

Tools

jirha

CLI for Jira operations. Auto-bootstraps into the workspace venv and loads .env. ~/bin/jirha is a symlink to scripts/jirha, so it works from any directory.

Run jirha --help for all commands. See docs/jira-reference.md for details.

pantheon-cli (moved)

pantheon-cli and visual-diff have moved to pantheon-cli.