background-agents
An open-source background agents coding system
Discover how background agents handle execution and inactivity timeouts with configurable settings managed by the SandboxSupervisor. Learn about asyncio wait_for and deadline checks.
How Integration Webhooks (Slack, Linear, GitHub) Trigger Session Creation in Background AgentsLearn how integration webhooks for Slack, Linear, and GitHub trigger background agent session creation. Understand the process from request validation to sandbox spawning.
D1 Database Schema for Session Index in Background Agents: Complete ReferenceExplore the D1 database schema for session index in background agents. Understand the normalized tables and composite indexes for efficient repository-scoped session management and metadata retrieval.
When Background Agents Use User OAuth Tokens vs GitHub App Tokens for Pull Request CreationLearn when background agents use user OAuth tokens versus GitHub App tokens for pull request creation. Understand authentication fallbacks and optimal token usage for your workflow.
How Git Branch Attribution Works Per Prompt in Background AgentsUnderstand how background agents manage Git branch attribution using session-level WebSocket messages, with prompts automatically inheriting the branch state.
How Artifact Media Streaming and Upload Work in Background AgentsLearn how background agents stream and upload artifact media using control-plane routes and React frontend utilities for seamless data handling. Explore the API endpoints for media management.
Repository Lifecycle Scripts in Background Agents: Understanding setup.sh and start.shUnderstand repository lifecycle scripts setup.sh and start.sh. Learn how these background agents scripts handle one-time provisioning and per-session runtime initialization for efficient deployments.
How the Callback Notification Delivery System Works in Background AgentsUnderstand how the callback notification delivery system works in background agents. Learn about secure HTTP callbacks signed JSON payloads and asynchronous processing for real-time notifications.
How Background-Agents Implements a Circuit Breaker Mechanism for Sandbox FailuresLearn how Background-Agents uses a circuit breaker mechanism to prevent sandbox failures. Discover the default thresholds and how it safeguards your system.
How the Automation Scheduler Processes Cron Triggers in Background AgentsDiscover how the automation scheduler processes cron triggers in background agents. Learn how it checks Git commits for changes to intelligently enqueue image rebuild jobs.
How Background Agents Handle Token Refresh for Model Providers and SCM IntegrationsDiscover how background agents manage token refresh for model providers and SCM integrations. Learn about static API keys and automated OAuth refresh flows.
How MCP Servers Are Integrated Per Repository in Background-AgentsLearn how Background-Agents integrates MCP servers per repository. Discover how scoped server definitions in D1 are resolved and configured for your runtime.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" 
Maintain an open-source project? Get it listed too →