Guides

Practical how-to documentation for fullsend, organized by audience. For design documents and architectural context, see docs/problems/, docs/ADRs/, and docs/architecture.md.

Getting started

Guides for onboarding organizations and configuring GitHub — the first thing most users need.

• Mint enrollment — Enroll your org or repo in a token mint before configuring anything else
• Getting Inference — Provision GCP inference access for your org or repo
• Configuring GitHub — Install GitHub Apps and run the setup CLI
• Organization Mode — Org-wide setup with a shared .fullsend config repo

Operations & Advanced Setup

Guides for organization owners and repository administrators who manage fullsend installations.

• Operations — Enrollment, configuration updates, status checks, uninstall, and standalone commands
• Advanced setup — Alternative installation paths, setup flags, custom app sets, and manual WIF configuration

Infrastructure

Advanced guides for platform operators who deploy and manage the GCP-side infrastructure (token mint, WIF, secrets).

• Mint service administration — Deploying and managing the token mint Cloud Function
• Standalone mint — Running the token mint as a standalone HTTP server without GCP
• Infrastructure reference — Token mint, WIF, and secrets deployment details
• Enabling fullsend on private repositories — Additional guardrails and configuration for private repos
• Distributed tracing — Configuring OpenTelemetry instrumentation and OTLP backends

User guides

Guides for developers working in repositories where fullsend is active.

• Bugfix workflow — End-to-end guide to how fullsend handles a bug report from issue to merge
• Running agents locally — Run fullsend agents on your machine using released binaries (macOS + Linux)
• Customizing agents — Harness configurations and layered content resolution for your org and repos
• Customizing with AGENTS.md — Guide agents using your repo's AGENTS.md file
• Customizing with skills — Extend or replace built-in agent skills with custom skill documents
• Building custom agents — Create a new agent from scratch on a per-repo fullsend installation

Development

Guides for contributors developing and testing fullsend itself.

• E2E testing — Local and CI e2e runs, including PR authorization and ok-to-test
• CLI internals — Command structure, installation pipeline, and sandbox runtime
• Testing workflow changes — Point a live GitHub org at a branch to test workflow, action, and agent changes before release