gh, or its MCP server.
GitHub
The r5d GitHub App answers commands in issues and pull requests with launch links, and shows the status of the shared sessions that work on them.Install and connect
- Install the app on your account or organization, for the repositories you want: github.com/apps/r5d-agents. It asks to read and write issues and pull requests, to read their comments and to comment; and to read an organization’s members, to check who connects it.
- GitHub then opens the app’s setup page. Sign in with GitHub. Only the account’s owner, or an owner of the organization, can connect it.
- Connect the installation to an r5d team. You need the team’s URL name and a team API key: a team admin creates one on the team’s Integrations page (
https://r5d.dev/t/<team>/integrations).
Start work from an issue or a pull request
Comment/r5d implement on an issue, or /r5d work on on a pull request. The app replies with a launch link. Open it, and r5d’s dialog shows:
- the repository, and your project for it (or an offer to add one);
- for an issue, a proposed new branch
issue/<number>-<title>from the default branch (you can work on an existing branch, such as the default branch, instead); for a pull request, its branch: yours in r5d, or a new one created from GitHub’s, with the same name, so the session’s pushes go to the pull request. No branch is created until you choose Start session; - the issue or pull request as a work item, with a snapshot of its description and latest comments: View issue shows it, and Copy issue copies it to paste into the first message;
- the first message,
Implement <issue URL>(Continue work on <pull request URL>for a pull request), for you to edit; - sharing with the installation’s team, all sessions on the branch, preselected. You can share the session another way or not at all. When the branch or the project is already shared with a team, the dialog shows that share instead.
Follow the work on GitHub
While a session is shared with the team, the issue or pull request it works on has a comment from the app with its status: starting, running, waiting for input, finished, failed or stopped. A session that isn’t shared with the installation’s team gets no comment. The comment is edited as the status changes, and links the read-only session page and the branch’s team page for the team’s members. When the share is revoked, the comment says so and stops changing. The app finds the sessions by their work items’ URLs, so this also works for a session that wasn’t started from the app: an agent can show an issue on its session withr5dctl session work-items add --url https://github.com/acme/api/issues/42 --label acme/api#42 … (work items), and once the session is shared with the team, the issue gets its comment.
When a pull request is opened for a shared branch, the app comments on it once with a link to the branch’s team page, where reviewers can follow every session shared with the team on that branch.
Threadline
Threadline has an r5d plugin.- A Threadline administrator enables it in Threadline’s admin settings, with r5d’s address, the team’s URL name and a team API key, what to share, and for each Threadline project the git remote and default branch it works on.
- Implement with r5d on an issue opens r5d’s dialog with the project’s repository, a new branch
issue/<number>-<title>, the issue with its description and comments as a snapshot, and the team share. - Board cards and issues show the status of the shared sessions working on them, with links to the sessions and their pull requests.
https://<your Threadline>/mcp and use the key as its bearer token. Threadline keys expire, after at most a year: replace the token in r5d before then.
Link a session to an issue
A session you didn’t start from Threadline can show on an issue too. Ask its agent to work on the issue; with Threadline’s MCP server it links its own session:- It shares its session with the team the plugin follows:
r5dctl share session --team <team>. - It calls Threadline’s MCP tool
r5d_link_addwith the issue’s number and its session’s ID. - It shows the issue on its session with the work item
r5d_link_addreturns:r5dctl session work-items add --url <url> --label <label> --short-label <short label> --title <title> --icon <icon>.
!358. Your account instructions can tell agents to do this whenever you ask them to work on a Threadline issue.