shitrat-github

name	shitrat-github
description	Post GitHub issue comments, PR reviews, and small file commits as the ShitRat GitHub App (`shitratgit[bot]`) instead of Joel. Use when reviewing PRs, commenting on issues, doing smoke tests, committing repo files through the GitHub API, or any workflow where GitHub authorship should be ShitRat.

ShitRat GitHub

Use ShitRat when GitHub should show shitratgit[bot] as the actor instead of Joel.

Default rule

Prefer ShitRat for published agent-authored GitHub comments/reviews:

shitrat status skillrecordings/migrate-egghead
shitrat comment skillrecordings/migrate-egghead 26 --body-file comment.md
shitrat review skillrecordings/egghead-next 1608 --event REQUEST_CHANGES --body-file review.md
shitrat commit-file joelhooks/shitrat-cli --branch main --message "docs: update notes" --file README.md
shitrat commit-files joelhooks/shitrat-cli --branch main --message "docs: update docs" --file README.md --file docs/shitrat-commit-flow.md

If the pi extension is loaded, prefer the tools:

• shitrat_status
• shitrat_comment
• shitrat_review
• shitrat_commit_file
• shitrat_commit_files

Safety rails

• Do not paste or print the private key.
• Do not use Joel's gh pr review when the desired actor is ShitRat.
• Use shitrat status <owner/repo> first when repo access is uncertain.
• Use --body-file for non-trivial Markdown so shell quoting does not mangle review text.
• Use shitrat commit-file ... --dry-run before writing unless Joel explicitly asked to commit as ShitRat.
• commit-file is for small, intentional single-file commits. commit-files is for small atomic multi-file GitHub API commits. For large/complex changes, commit locally and push normally unless Joel specifically wants ShitRat API commits.
• Only post comments/reviews/commits when the user asked to publish or the workflow clearly requires it.

Secrets

The CLI reads env first, then agent-secrets leases:

• shitrat_github_app_id
• shitrat_github_private_key
• shitrat_github_installations_json
• shitrat_github_installation_id_<owner_key> as fallback

Known owner keys:

• joelhooks
• badass_courses
• skillrecordings
• wzrrd_sh

Install as pi package

From the repo root:

pi install /Users/joel/Code/joelhooks/shitrat-cli

Or once pushed:

pi install git:github.com/joelhooks/shitrat-cli