Skip to content

Installing Fullsend in Organization Mode

The goal of this document is that you install Fullsend for your whole GitHub organization, so different repositories share inference and infrastructure.

Note: this document assumes you already read and used Getting Inference and Configuring GitHub. If that is not the case, read those guides first.

Differences With Repository Installation

When you install Fullsend in Organization Mode there are a few key differences:

  • fullsend inference provision is executed once for the whole organization.
  • GitHub workflows are executed in a .fullsend repository within the organization.
  • Individual repositories need to be enrolled to be able to execute Fullsend.

Getting Inference For The Organization

Similar to the command ran at Getting Inference you need to run:

bash
fullsend inference provision <org> --project <gcp-project>

Where <org> is the GitHub organization and <gcp-project> is your GCP project.

text
⚡ fullsend <version>
  Autonomous agentic development for GitHub organizations

→ Provisioning WIF for org-scoped inference: <org>

  • Provisioning WIF infrastructure
  ✓ WIF infrastructure ready

    WIF Provider: projects/<number>/locations/global/workloadIdentityPools/fullsend-inference/providers/github-oidc

    Pass this value to the GitHub setup command:
      fullsend github setup <org> \
        --inference-project=<gcp-project> \
        --inference-wif-provider=projects/<number>/locations/global/workloadIdentityPools/fullsend-inference/providers/github-oidc

Note down the WIF Provider URL which is used in the next step to configure the organization.

Configure GitHub Apps

If you previously ran the Configuring GitHub guide the Fullsend apps you installed are configured just for a single repository. Change the permissions so they can access all repositories or .fullsend (not created yet) and any other repository you want to enable Fullsend for.

Configure GitHub

Now similar to the command executed on Configuring GitHub, execute:

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

Where <org> is the GitHub organization, <gcp-project> is your GCP project and <wif-provider-url> is the URL from the previous step.

This command creates a .fullsend repository in your organization and starts a workflow that enrolls repositories if needed.

Enroll Repositories

After installing enroll repositories by running:

bash
fullsend github enroll <org> <repo> [<repo>...]

This changes the config.yaml present in the .fullsend repository and that starts a workflow there. The workflow adds or removes the .github/workflows/fullsend.yaml of the repositories.

Testing Fullsend

After merging the .github/workflows/fullsend.yaml workflow in the enrolled repositories, open a new issue or comment /fs-triage in an issue of one of the enrolled repositories to see Fullsend in action.

Next Steps

  • Read the Default Agents section to learn about the default agents Fullsend ships with.
  • Explore other sections of this documentation for more information.