# GitHub App on boxd

> Your organization's GitHub. Git and gh on shared machines, and automations on any machine.

GitHub App is built into boxd, not called through `run`: connect it once in the console (https://app.boxd.sh/integrations).

- Page: https://boxd.sh/integrations/github-app/
- Docs: https://docs.boxd.sh/guides/integrations/connections#github-app
- All integrations: https://boxd.sh/integrations/ (Markdown: https://boxd.sh/integrations/index.md)

## How it works

- **Install once.** An org admin installs it from the console.
- **Shared machines.** git and gh are signed in with short-lived tokens. `gh pr list`
- **Scripts.** githubApp is an authenticated client with typed events. `run github-app get-token`