From 816bd69f975bddc3f3b6d145d06a92a7dab683c5 Mon Sep 17 00:00:00 2001
From: robojerk <rob@raines.xyz>
Date: Tue, 26 Aug 2025 17:00:30 -0700
Subject: [PATCH] Updated readme

---
 README.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/README.md b/README.md
index 52da7b8c..a31b17b2 100644
--- a/README.md
+++ b/README.md
@@ -77,6 +77,37 @@ Testing requires additional software:
 - **bookworm** (Debian 12) - OLDSTABLE - Limited compatibility
 - **bullseye** (Debian 11) - OLDOLDSTABLE - Not supported
 
+## Dynamic Runner System
+
+Debian Forge automatically detects your distribution and uses the appropriate runner, just like Fedora OSBuild:
+
+```bash
+# OSBuild automatically detects and uses the right runner
+$ ls -la runners/
+org.osbuild.debian13*    # Debian 13 (Trixie) runner
+org.osbuild.debian14*    # Debian 14 (Forky) runner  
+org.osbuild.ubuntu2504*  # Ubuntu 25.04 (Plucky Puffin) runner
+org.osbuild.ubuntu2404*  # Ubuntu 24.04 (Noble Numbat) runner
+org.osbuild.debian-based* # Generic Debian-based runner
+org.osbuild.linux*       # Generic Linux runner
+```
+
+### Automatic Setup
+
+```bash
+# Setup the appropriate runner for your system
+$ ./tools/debian-runner-setup
+
+# List available runners
+$ ./tools/debian-runner-setup list
+```
+
+### Supported Distributions
+
+- **Debian**: Trixie (13), Forky (14), Sid (unstable)
+- **Ubuntu**: 24.04 LTS, 25.04 LTS, and future releases
+- **Other**: Linux Mint, Pop!_OS, Elementary OS, Zorin OS, Kali Linux, Parrot OS
+
 ## Running locally
 
 The main binary is safe to run on your development machine with: