GitHub Digest
A scheduled pull request briefing workspace. Every Monday and Thursday at 8:30am Pacific, it scans GitHub for your open PRs and pending review requests, and surfaces a clean digest — no dashboard to open, no GitHub inbox to scan.
The digest is organized into three sections:
- Your Open PRs — title, repo, URL, age, and current review status (approved / changes requested / awaiting)
- Review Requested — PRs where you're asked to review, with title, repo, URL, and author
- Summary — one sentence on total counts and any urgent items
Setup
1. Download Friday
- Go to hellofriday.ai and download the macOS installer
- Open the DMG and drag Friday to your Applications folder
- Launch Friday and complete the initial setup
2. Import the workspace
- Open Friday and go to Discover Spaces
- Find this workspace and click it
- Click Add Space
3. Connect GitHub
GitHub Digest uses the GitHub MCP server, which needs a personal access token to query your PRs and review requests.
Generate a token
- Go to github.com/settings/tokens
- Click Generate new token (classic)
- Give it a name (e.g.
friday-digest) - Select the following scopes:
repo— to read pull requests across your reposread:user— to resolve your GitHub username automatically
- Click Generate token and copy it — you won't see it again
Connect it in Friday
- Open the imported workspace and start a chat
- Friday will detect that GitHub needs credentials and surface a Connect GitHub prompt
- Paste your token when asked
- You're connected — no further setup needed
4. That's it
No email recipient to configure, no additional MCP servers to enable. The digest runs against your authenticated GitHub account and outputs directly to the workspace session.
How it works
| Component | Role |
|---|---|
github-digest-agent |
LLM agent (Claude Opus) that queries GitHub for your open PRs and review requests, then formats a Markdown digest |
github-digest-job |
Three-state FSM: idle → run agent → done |
github-digest-schedule |
Schedule signal firing at 30 8 * * 1,4 in America/Los_Angeles (8:30am Pacific, Monday and Thursday) |
github MCP server |
Provides get_me, search_pull_requests, and pull_request_read tools |
The schedule fires the github-digest-schedule signal, which starts the github-digest-job FSM. The FSM runs github-digest-agent in a single step, which calls GitHub MCP tools in sequence — get the authenticated user, search authored PRs, search review-requested PRs — then renders the digest and stores it in digest-result.
