Introduction
AgentFork is infrastructure that makes open-source repositories instantly forkable. When someone forks your project, they get more than just code — they get a fully provisioned environment with databases, services, environment variables, and a live preview URL.
No Docker. No local setup. No "works on my machine." Whether it's a first-time contributor, a senior engineer evaluating your architecture, or an AI agent writing a patch — everyone gets a working environment in seconds.
Quick Start
Get a repository running on AgentFork in three steps.
Link your GitHub account
Sign in with GitHub and authorize AgentFork to access your repositories. We only request the permissions needed to read your repo structure — no write access required.
Select a repo and hit Index
Pick a repository from your account and press Index. AgentFork's AI will scan the entire codebase — config files, dependency manifests, ORM schemas, Docker definitions — and automatically generate an agentfork.yml blueprint with everything detected.
Go live
That's it. Your project is now forkable. Every fork automatically gets a fully provisioned environment — databases, services, environment variables — and a unique live preview URL. Contributors go from fork to running code in seconds.
Stack Detection
How AgentFork understands your project.
When you index a repository, AgentFork's AI engine scans the entire project and builds a dependency graph. It reads config files, dependency manifests, ORM schemas, Docker definitions, and environment files to determine exactly what your project needs to run — including all environment variable names.
Everything detected is written into an agentfork.yml file. You can review it, customize it, or just let the AI handle it entirely.
What gets detected
| Signal | Files | Detects |
|---|---|---|
| Package manager | package.json, bun.lockb | Runtime, dependencies, scripts |
| Framework config | svelte.config.js, next.config.* | Framework, build pipeline |
| ORM schemas | schema.prisma, drizzle.config.* | Database type, migrations |
| Docker | docker-compose.yml | Services, ports, volumes |
| Environment | .env, .env.example, .env.local | All env variable names, connection strings |
Environments
Isolated, ephemeral infrastructure for every fork.
Each fork of your project gets a completely isolated environment — its own database instances, cache layers, environment variables, and compute. Environments are provisioned on-demand when a fork is created and automatically torn down after a period of inactivity.
Lifecycle
Live Preview URLs
Every fork gets a unique, shareable URL.
When an environment is provisioned, AgentFork assigns it a unique subdomain on *.agentfork.dev. These URLs are publicly accessible and can be shared in pull requests, issue comments, or Slack threads.
URL format
| Context | Example URL |
|---|---|
| Pull request | pr-42.agentfork.dev |
| Branch preview | feat-auth-redesign.agentfork.dev |
| Contributor fork | jdoe-my-project.agentfork.dev |
Supported Stacks
Frameworks, runtimes, and services we support today.
Frameworks
- Next.js
- SvelteKit
- Nuxt
- Remix
- Express / Fastify
- Rails planned
- Django planned
Services
- PostgreSQL
- Redis
- MySQL
- MongoDB
- Elasticsearch planned
- RabbitMQ planned
- MinIO (S3) planned
agentfork.yml
The configuration file that powers every environment.
The agentfork.yml is the single source of truth for how your project's environments are provisioned. It's auto-generated when you index a repository — the AI detects your framework, runtime, databases, setup commands, environment variables, and dev server configuration. You can customize it anytime from the dashboard.
Full reference
You don't need to write this yourself. The AI generates the entire agentfork.yml when you index your repo — including environment variable names, setup commands, and service versions. You can edit it from the dashboard at any time.
API Reference
Programmatic access to AgentFork.
API documentation is coming soon.
The REST API will let you programmatically manage environments, trigger indexing, and query status. Join early access to be notified when it launches.
Ready to make your repo forkable?
Get early access and start onboarding your project today.