From 7aedf04f34d94efc56229c6cffa40d0ab3fd411e Mon Sep 17 00:00:00 2001
From: "roux g. buciu" <github@adudenamedruby.com>
Date: Fri, 13 Feb 2026 09:36:08 -0500
Subject: [PATCH] Update readme with local test workflow

---
 README.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 1375fa9..cbaa66b 100644
--- a/README.md
+++ b/README.md
@@ -88,17 +88,23 @@ Sources/fxios/
 └── Commands/
 ```
 
-### Dev Notes
+### Development Tips
 
 ```bash
 # Build
 swift build
 
-# Run locally
+# Run in the fxios-ctl folder
 swift run fxios
 ```
 
-### Testing Notes
+To test your local changes in a `firefox-ios` repo, it's recommened to create an alias, and using that after running `swift build` in the `fixios-ctl` repo to build your latest changes.
+
+For example: `alias fxtest=path/to/fxios-ctl/.build/arm64-apple-macosx/debug/fxios`
+
+If you're on an Intel machine, you might have to have a slightly different path.
+
+### Unit Testing Notes
 
 Tests use the modern Swift Testing framework (`@Test`, `@Suite`, `#expect`).