Limits that stay shared.
Add workers without multiplying your rate budget. Concurrency and rate limits apply across the entire fleet.
Explore fleet policies Open source. Built for the whole fleet. Background jobs.
Background jobs.
Fleet-wide control.
Shared rate limits. Fair tenants. Workers in sync.
Background jobs for Go and Rust, on the database you already use.
Apache 2.0+Self-hosted+Go & Rust
Long-running agents. One shared gate.
INTERACTIVE SIMULATION
01 / QUEUED AGENT RUNS
Acme4 queued
2 admitted2 waiting
Orbit4 queued
2 admitted2 waiting
Nova4 queued
2 admitted2 waiting
headgateOne atomic decision.
Agent start rate
Tenant fairness
Concurrency cap
6 agent runs admitted
02 / YOUR WORKER FLEET
worker-01Planning research
worker-02Planning research
worker-03Planning research
6 agents running0 slots available
Admitted jobs Waiting for admissionAgent elapsed: 00:00 · simulated
Workers
Agent runs hold their slots while they research, synthesize, and save results. Every job starts under the same fleet policy.
Time-compressed simulation: 12-minute agent runs, with 2 minutes per tick. Controls restart the scenario. Limits apply to job starts, not model tokens.
YOUR STORE. YOUR INFRASTRUCTURE.
PostgreSQL
MySQL
Redis
01 — ADMISSION, NOT JUST DEQUEUEOne fleet.
One fleet.
One set of rules.
Every worker asks the same question: “What am I allowed to run?” Headgate evaluates your policies atomically inside the store, in the same operation that claims the job.
A fair turn for every tenant.
A busy tenant shouldn’t drown out everyone else. Quiet tenants get service, and spare capacity stays useful.
Understand admissionBad jobs stop spreading.
Correlate repeated crashes by payload fingerprint. Quarantine troublesome work before it keeps taking down workers.
See quarantine controls02 — WRITE THE JOB. WE’LL COORDINATE.Your language.
Your language.
Your kind of job.
A research agent that runs for minutes. A multi-step analysis. Define a typed handler and let Headgate coordinate execution across your fleet.
- First-class Go and Rust SDKs
- Shared wire format and conformance suite
- Install only the backend you need
01
Define your job.
Give your agent a typed payload and a stable job kind.
type ResearchAgent struct {
Question string `json:"question"`
}
func (ResearchAgent) Kind() string {
return "agent:research"
}
Integration fragment · see full setup below.Full setup
02
Bring your agent logic.
Register a handler. Your application supplies the research logic.
registry := headgate.NewRegistry()
err := headgate.RegisterFunc[ResearchAgent](registry,
func(ctx context.Context,
job *headgate.Job[ResearchAgent]) error {
return runResearchAgent(ctx, job.Args.Question)
},
)
if err != nil {
return err
}
Integration fragment · see full setup below.Full setup
03
Send it to the fleet.
Enqueue through the client. Workers claim under shared policies.
payload, err := json.Marshal(ResearchAgent{
Question: "What changed in our market?",
})
if err != nil {
return err
}
client := headgate.NewClient(store)
return client.Enqueue(ctx, []headgate.Envelope{{
ID: jobID, Kind: ResearchAgent{}.Kind(),
SchemaVersion: 1, Payload: payload,
Queue: "research", PartitionKey: "tenant-a",
MaxAttempts: 3, RetentionMs: 86_400_000,
}})
Integration fragment · see full setup below.Full setup
Fragments assume an initialized store, a running worker, and a unique job ID. Your application supplies its model and tool calls.
AGENT SKILL
Your coding agent, up to speed.
Give your coding agent Headgate-specific guidance for producers, workers, resumable steps, and workflows. Includes Go and Rust references and operational troubleshooting.
Explore the skill Add to your agent’s toolkit
npx skills add Mujhtech/headgateInstall with the Skills CLI in your project.
03 — ROOM FOR THE COMPLEX PARTSStart with a job.
Start with a job.
Keep building.
Research that takes minutes. Agent runs that span hours. Explore the mechanics that keep the work moving.
Fleet-wide limits
One start-rate budget. One concurrency ceiling. Shared by every worker, even as your fleet grows.
SHARED START BUDGET6 / window
0 starts admitted6 starts left
One budget for the entire fleet
Resume the work. Keep the progress.
A worker can disconnect halfway through an agent run. Completed steps stay recorded; the next worker retries the interrupted step.
research_agentRunning · attempt 1
Collect sourcesCheckpoint saved
savedSynthesize findingsReviewing source material…
Save reportWaiting for previous step
1 of 3 steps complete
Durable checkpoints. Fence-verified writes.
Progress you can follow
Watch your agent work through sources, record durable output, and return a versioned result.
research_agent
Sources reviewed
3/ 24
Reading evidence and recording progress.
Stop the crash loop
Correlate repeated crashes across workers. Quarantine matching payloads so healthy work can keep moving.
Crash fingerprint
a7f2run_82aworker-01crashedCorrelating crashes across workers
Give agents a workflow
Run independent research in parallel. Start the report only when its dependencies complete.
Plan
Research
Analyze
Report
Right on schedule
A daily research digest or work for later. Delayed and periodic jobs use the same fleet policies when they become eligible.
Research digest
09:00 UTCMONenqueued
TUE
scheduled
WED
scheduled
THU
scheduled
FRI
scheduled
04 — SEE WHAT’S REALLY HAPPENING“Why isn’t this
“Why isn’t this
job running?”
A question your queue should answer. Inspect admission decisions, follow workflows, and manage your fleet from the embedded console.
Meet the operations consoleEmbedded in your Go or Rust binary.
Trust is built.
Then tested.
Two languages. Three stores. One shared behavioral contract. Headgate’s conformance suite exercises admission, lifecycle, and cross-language behavior against real backends.
Explore the verification suiteSUPPORTERS
Help build what’s next.
Headgate is early, open source, and looking for its first supporters. Help us keep building reliable background jobs.
Get involved on GitHubYour logo could be hereA place for our first supporter.
Your next job starts here.
Pick your language. Bring your database. Let’s get to work.
Get started with Headgate Early public release. Your feedback shapes what comes next.