Skip to content

Configuring GitHub For Fullsend

The goal of this document is that you configure Fullsend for your GitHub repository.

Prerequisites

  • Your org or repo is enrolled in a fullsend token mint service (see Getting Started step 1).
  • You have your WIF provider URL from Getting Inference.
  • Download the latest fullsend CLI.
  • Download the latest gh CLI and authenticate with it.

Installing GitHub Applications

In order to use Fullsend install the following applications to your organization and provide them permissions to the repository you want to install Fullsend to.

RoleInstallation URL
fullsend<https://github.com/apps/fullsend-ai-fullsend/installations/new>
triage<https://github.com/apps/fullsend-ai-triage/installations/new>
coder<https://github.com/apps/fullsend-ai-coder/installations/new>
review<https://github.com/apps/fullsend-ai-review/installations/new>
retro<https://github.com/apps/fullsend-ai-retro/installations/new>
prioritize<https://github.com/apps/fullsend-ai-prioritize/installations/new>

Note: Installing a subset of GitHub Apps does not automatically limit which agents are active. You must also pass the --agents flag (see below) to match the set of apps you installed. For example, if you only install the triage and review apps, pass --agents triage,review when running setup.

Configuring GitHub

Run the command:

bash
fullsend github setup <org>/<repo> \
  --inference-project "<gcp-project>" \
  --inference-wif-provider "<wif-provider-url>"

Where <org>/<repo> refers to the GitHub organization and repository you want to enable inference for, <gcp-project> is your GCP project name, and <wif-provider-url> is the WIF Provider URL created at Getting Inference.

The command creates files, secrets and variables in your repository.

Enabling a subset of agents

By default, the setup command configures all available agent roles. To enable only specific agents, pass the --agents flag with a comma-separated list of roles:

bash
fullsend github setup <org>/<repo> \
  --inference-project "<gcp-project>" \
  --inference-wif-provider "<wif-provider-url>" \
  --agents triage,review

Only the listed agents will be configured. Make sure you have installed the corresponding GitHub Apps for each agent you enable (see the table above).

For the full list of setup flags, see the CLI reference.

Testing Fullsend

After installing open a new issue or comment /fs-triage in an open issue. Then visit the Actions tab to see the Fullsend workflow in action. In some minutes the fullsend-ai-triage bot should post a comment in the issue.

Next steps

  • Read Organization installation mode to learn how to share GCP project with other repositories within your GitHub organization.
  • Read the Default Agents section to learn about the default agents Fullsend ships with.
  • Explore other sections of this documentation for more information.