docs(examples): add set_paths.lua helper and update example usage documentation

Author: toasted323

README.md

@@ -65,6 +65,12 @@ root:parse({"remove", "2"})
 
 See other examples in the [`examples/`](examples/) directory.
 
+> Use [`set_paths.lua`](set_paths.lua) to run examples locally:
+>
+> ```
+> lua -l set_paths examples/basic_usage.lua
+> ```
+
 ## Attribution
 
 If you create a new project based substantially on this CLI library, please
@@ -80,3 +86,4 @@ Copyright © 2025 github.com/toasted323
 
 This project is licensed under the MIT License.  
 See [LICENSE](LICENSE) in the root of this repository for full details.
+```

set_paths.lua

@@ -0,0 +1,18 @@
+local base_path = os.getenv("BASE_PATH") or "./"
+local lua_version = "5.1"
+local path_sep = package.config and package.config:sub(3,3) or ';'
+
+package.path = table.concat({
+    base_path .. "/src/?.lua",
+    base_path .. "/src/?/init.lua",
+    base_path .. "/lua_modules/share/lua/" .. lua_version .. "/?.lua",
+    base_path .. "/lua_modules/share/lua/" .. lua_version .. "/?/init.lua",
+    package.path
+}, path_sep)
+
+package.cpath = table.concat({
+    base_path .. "/lua_modules/lib/lua/" .. lua_version .. "/?.so",
+    package.cpath
+}, path_sep)
+
+return true