Wikis and notes

Guile and GitHub

Pull request and issue discussions, plus prose documentation.

What Guile reads from GitHub

Guile reads issue and pull request conversations, Discussions, and READMEs and documentation files, and checks again every night. It skips code, diffs, commits and review comments, and removes code blocks and anything that looks like a password or key. GitHub's page says the app can also change your code, issues and webhooks. Guile never does: it only reads.

How to connect GitHub

  1. In Guile, open Apps > Add an app and choose Connect on GitHub. To keep it to yourself, open Settings > Apps instead.
  2. In the Pipedream window (the service Guile uses to connect apps), sign in to GitHub. GitHub's page names Pipedream, not Guile; that is expected.
  3. Next to each organization whose repositories Guile should read, choose Grant if you own it, or Request to ask its owners.
  4. Choose Authorize.
  5. Back in Guile, learning starts with every repository you can open. To keep to one, choose Choose sources and enter it under Repository (owner/name).

For an organization owner: on GitHub open your profile picture > Organizations, choose the organization and Settings, then under Third-party Access choose OAuth app policy, Review next to the app, and Grant access.

If something doesn't work

  • An organization's repositories are missing: its owner has not approved the app yet. Ask them, or request access from GitHub's Settings > Applications > Authorized OAuth Apps, then the app's name > Request access > Request approval from owners.
  • Guile stops with "GitHub did not grant repository read access": choose Disconnect, then connect again.
  • Your account opens more than 250 repositories: Guile stops rather than skip some, even when you chose one repository. Connect an account that sees fewer.

Still stuck? Write to hello@goguile.com.