fullsend github

Configure fullsend on GitHub organizations and repositories without requiring GCP credentials. All GCP infrastructure values (mint URL, WIF provider) are passed as flags.

Commands

Command	Description
fullsend github setup <org|owner/repo>	Configure fullsend for an org or repo
fullsend github enroll <org> [repo...]	Enable repositories for agent workflows
fullsend github unenroll <org> [repo...]	Disable repositories from agent workflows
fullsend github set <target> <key> <value>	Update a single config value (secret or variable)
fullsend github status <org>	Analyze GitHub-side installation state
fullsend github sync-scaffold <org>	Update workflow templates to current CLI version
fullsend github uninstall <org>	Remove fullsend GitHub configuration

github setup

Configures a GitHub organization or repository with fullsend. Creates the .fullsend config repo (per-org mode), installs GitHub Apps, and sets variables and secrets.

Per-org mode requires GitHub organization owner access:

fullsend github setup <org> \
  --mint-url="<MINT_URL>" \
  --inference-project "<GCP_PROJECT>" \
  --inference-wif-provider "<WIF_PROVIDER>"

Per-repo mode requires repo admin access only:

fullsend github setup <owner/repo> \
  --mint-url="<MINT_URL>" \
  --inference-project "<GCP_PROJECT>" \
  --inference-wif-provider "<WIF_PROVIDER>"

Re-running per-repo setup (for example after a fullsend upgrade) refreshes the managed workflow files but never rewrites an existing .fullsend/config.yaml on its own: agents: entries and their per-agent settings, allowlists and hand-written comments stay as they are, the runtime prompt is skipped, and the setup PR reports the runtime the file already selects. Passing a flag that targets a config key — --runtime, --agents, --mint-url, --inference-* — changes that key on the existing file and keeps the rest (the file is re-serialized, so comments are not preserved in that case). --config rewrites config.base.yaml and keeps the existing overlay. A config.yaml that no longer parses fails the re-run rather than being regenerated.

Flags

Flag	Default	Description
--mint-url		HTTPS endpoint of the token mint service
--inference-provider		Inference provider; resolved to vertex if unset
--inference-project		GCP project ID for Agent Platform
--inference-wif-provider		Full WIF provider resource name
--openai-audience		OpenAI Workload Identity audience for GPT on pi; with the two flags below, written to inference.openai in config.yaml (all three or none)
--openai-identity-provider-id		OpenAI Workload Identity provider ID
--openai-service-account-id		OpenAI service account ID the provider maps this repository to
--inference-region		GCP region for inference; resolved to global if unset
--skip-app-setup	false	Skip GitHub App creation/installation
--app-set	fullsend-ai	App set name prefix for GitHub Apps
--agents	fullsend,triage,coder,review,retro,prioritize	Agent roles to provision
--direct	false	Push scaffold directly instead of creating a PR
--runtime	claude	Agent runtime backend (claude, pi, dummy or dummy-playback; dummy and dummy-playback are for behaviour test orgs only — see runtimes.md)
--config		Local file path or HTTPS URL to a vendor preset (committed as .fullsend/config.base.yaml; per-repo only)
--config-hash		SHA-256 hex digest to validate the preset content (requires --config)

Required OAuth scopes

Scope	Per-org	Per-repo
repo	x	x
workflow	x	x
admin:org	x

github enroll

Enables agent workflows on repositories by updating config.yaml in the .fullsend repo and triggering enrollment PRs.

fullsend github enroll <org> <repo-name> [repo-name...]
fullsend github enroll <org> --all

github unenroll

Disables agent workflows on repositories.

fullsend github unenroll <org> <repo-name> [repo-name...]
fullsend github unenroll <org> --all [--yolo]

The --all flag prompts for confirmation. Pass --yolo to skip the prompt.

github set

Updates a single configuration value (secret or variable) on a GitHub org or repo.

fullsend github set <org|owner/repo> <key> <value>

github status

Analyzes the GitHub-side installation state. Read-only.

fullsend github status <org>

github sync-scaffold

Updates workflow templates in enrolled repositories to match the current CLI version.

fullsend github sync-scaffold <org>

github uninstall

Removes fullsend GitHub configuration for an organization. Deletes the .fullsend config repo and associated resources.

fullsend github uninstall <org> [--yolo] [--app-set <name>]

See also

• Configuring GitHub for fullsend — getting started guide
• Advanced setup — non-standard installation paths and setup flags
• Operations — day-2 administration (enrollment, status, uninstall)