Daytona Background Agents

Building blocks for running AI coding agents in isolated Daytona sandboxes. Can be used in your own projects or as a standalone NextJS app:

https://github.com/user-attachments/assets/ee6de7e9-a32e-45bd-acfa-3da1763b80ea

Packages

Published packages

On npm — use them in your own projects.

Package	Description	Maintainer
agent-configuration	Translation layer between coding agents' configuration formats
claude-credentials	Claude Code OAuth credential generation via ccauth and Daytona
launcher	npx background-agents launcher that runs the desktop app
mcp	MCP provider integrations
sandbox-git	Git operations for Daytona sandboxes
sandbox-jobs	Run, observe, and reconnect to long-running shell processes in a Daytona sandbox via the filesystem
sandbox-skills	Agent skills integration for Daytona sandboxes
sandbox-terminal	WebSocket-based PTY terminal for Daytona sandboxes
sdk	TypeScript SDK for running AI coding agents in Daytona sandboxes

Internal packages

Not published — apps and shared internals used only in this repo.

Package	Description	Maintainer
common	Shared utilities and types
desktop	Electron desktop app for Background Agents
dev-cron	Local development simulator for Vercel cron jobs
docs	Standalone docs site deployed to docs.backgrounder.dev
sandbox-image	Custom Daytona sandbox image with pre-installed agent CLIs
web	Standalone chat app for AI coding agents

---

Prerequisites

• Node.js 20.9+ (required by Next.js 16)

Quick start (Web)

Set up a local Postgres database and a .env.local file with the variables listed under Development.

npm install
npm run prisma:migrate
npm run dev

Open http://localhost:4000.

Quick start (Desktop)

The desktop app loads the web app, so it has the same prerequisites as the Web quick start above.

npm install
npm run dev:electron

This starts the local web server and launches the Electron app.

Deployment

The web package deploys to Vercel. See Deployment for env vars and configuration.