From 26b42ecd6793509b388f7e70b10323e35f5570ab Mon Sep 17 00:00:00 2001
From: ajmallesh <ajmallesh@gmail.com>
Date: Mon, 15 Dec 2025 10:34:24 -0800
Subject: [PATCH] docs: add Docker instructions for testing local applications

Co-Authored-By: Khaushik-keygraph <khaushik.contractor@keygraph.io>
---
 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index 1343dbf..cc379af 100644
--- a/README.md
+++ b/README.md
@@ -198,6 +198,25 @@ docker run --rm -it \
 - `--cap-add=NET_ADMIN` - Allows network administration for security tools
 - `--network host` - Provides access to target network interfaces
 
+**Testing Local Applications:**
+
+Docker containers cannot reach `localhost` on your host machine. Use `host.docker.internal` in place of `localhost`:
+
+```bash
+docker run --rm -it \
+      --add-host=host.docker.internal:host-gateway \
+      --cap-add=NET_RAW \
+      --cap-add=NET_ADMIN \
+      -e CLAUDE_CODE_OAUTH_TOKEN="$CLAUDE_CODE_OAUTH_TOKEN" \
+      -e CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000 \
+      -v "$(pwd)/repos:/app/repos" \
+      -v "$(pwd)/configs:/app/configs" \
+      shannon:latest \
+      "http://host.docker.internal:3000" \
+      "/app/repos/your-app" \
+      --config /app/configs/example-config.yaml
+```
+
 ### Configuration (Optional)
 
 While you can run without a config file, creating one enables authenticated testing and customized analysis.