README
¶
Fullsend
Autonomous agentic software development for Git-hosted organizations (GitHub, GitLab, Forgejo).
Fullsend agents triage issues, implement solutions, review code, and merge to production autonomously — while being secure by design.
Documentation
Visit fullsend.sh for the full documentation, including getting started guides, agent reference, architecture decisions, and design documents.
How to contribute
See CONTRIBUTING.md for the contribution workflow, vouch process, and commit conventions.
When in doubt, start with an issue.
License
This project is licensed under the Apache License, Version 2.0.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
fullsend
command
|
|
|
internal
|
|
|
appsetup
Package appsetup handles creating and installing per-role GitHub Apps using the manifest flow.
|
Package appsetup handles creating and installing per-role GitHub Apps using the manifest flow. |
|
dispatch
Package dispatch defines the Dispatcher interface for provisioning dispatch infrastructure during install.
|
Package dispatch defines the Dispatcher interface for provisioning dispatch infrastructure during install. |
|
dispatch/gcf
Package gcf implements the dispatch.Dispatcher interface using a GCP Cloud Function as the token mint.
|
Package gcf implements the dispatch.Dispatcher interface using a GCP Cloud Function as the token mint. |
|
envfile
Package envfile provides a simple dotenv file parser.
|
Package envfile provides a simple dotenv file parser. |
|
fetch
Package fetch provides an SSRF-hardened HTTP client for safely retrieving content from external URLs.
|
Package fetch provides an SSRF-hardened HTTP client for safely retrieving content from external URLs. |
|
fetchsvc
Package fetchsvc provides a runtime skill fetch service for agents running in sandboxes.
|
Package fetchsvc provides a runtime skill fetch service for agents running in sandboxes. |
|
forge
Package forge defines the interface for interacting with git forges (GitHub, GitLab, Forgejo).
|
Package forge defines the interface for interacting with git forges (GitHub, GitLab, Forgejo). |
|
forge/github
Package github implements forge.Client for the GitHub REST API.
|
Package github implements forge.Client for the GitHub REST API. |
|
forge/gitlab
Package gitlab implements forge.Client for the GitLab REST API v4.
|
Package gitlab implements forge.Client for the GitLab REST API v4. |
|
gcp
Package gcp provides authenticated HTTP access to GCP APIs using Application Default Credentials.
|
Package gcp provides authenticated HTTP access to GCP APIs using Application Default Credentials. |
|
gitfetch
Package gitfetch fetches directory trees from git repositories using sparse checkout, providing a forge-agnostic alternative to REST API directory listing.
|
Package gitfetch fetches directory trees from git repositories using sparse checkout, providing a forge-agnostic alternative to REST API directory listing. |
|
inference
Package inference defines the interface for provisioning inference provider credentials during fullsend installation.
|
Package inference defines the interface for provisioning inference provider credentials during fullsend installation. |
|
inference/vertex
Package vertex implements the inference.Provider interface for Google Cloud Vertex AI using Workload Identity Federation with GitHub OIDC.
|
Package vertex implements the inference.Provider interface for Google Cloud Vertex AI using Workload Identity Federation with GitHub OIDC. |
|
lock
Package lock reads and writes .fullsend/lock.yaml files that pin all resolved remote dependencies (URLs and integrity hashes) for reproducible harness execution.
|
Package lock reads and writes .fullsend/lock.yaml files that pin all resolved remote dependencies (URLs and integrity hashes) for reproducible harness execution. |
|
netutil
Package netutil provides shared network utilities for IP classification.
|
Package netutil provides shared network utilities for IP classification. |
|
normevent
Package normevent defines forge-neutral NormalizedEvent types for harness CEL dispatch (ADR 0061).
|
Package normevent defines forge-neutral NormalizedEvent types for harness CEL dispatch (ADR 0061). |
|
poll
Package poll implements the GitLab cron-polling event dispatch loop.
|
Package poll implements the GitLab cron-polling event dispatch loop. |
|
repos
Package repos provides reusable per-repo installation logic for fullsend.
|
Package repos provides reusable per-repo installation logic for fullsend. |
|
security
Package security provides input sanitization and output scanning for fullsend's agent entrypoints.
|
Package security provides input sanitization and output scanning for fullsend's agent entrypoints. |
|
sentencetoken
Package sentencetoken splits text into sentences using the Punkt algorithm.
|
Package sentencetoken splits text into sentences using the Punkt algorithm. |
|
skill
Package skill parses SKILL.md frontmatter for transitive dependency resolution.
|
Package skill parses SKILL.md frontmatter for transitive dependency resolution. |
|
statuscomment
Package statuscomment posts agent start/completion status comments on issues and pull requests via the forge abstraction.
|
Package statuscomment posts agent start/completion status comments on issues and pull requests via the forge abstraction. |
|
telemetry
Package telemetry implements fullsend's distributed tracing (ADR 0050).
|
Package telemetry implements fullsend's distributed tracing (ADR 0050). |
|
urlutil
Package urlutil provides URL validation and integrity-hash utilities shared by config (agent entry validation) and harness (remote resource resolution) packages.
|
Package urlutil provides URL validation and integrity-hash utilities shared by config (agent entry validation) and harness (remote resource resolution) packages. |
|
mintcore
module
|
|
|
pkg
|
|
Click to show internal directories.
Click to hide internal directories.