initialize AGENTS.md

AGENTS.md

@@ -0,0 +1,38 @@
+# LXST Client
+
+Single-file Python CLI for managing LXST Channel connections via Reticulum Network (RNS) and LXMF protocols.
+
+## Running
+
+  python client.py [-c CONFIGDIR] [-w WHITELIST]
+
+  Options:
+    -c, --config  : config directory (default: ~/.lxst-client or /etc/lxst-client)
+    -w, --whitelist: path to bridge_whitelist.json
+    -v, --verbose : enable debug logging
+    --rnsconfig   : alternative Reticulum config directory
+
+## Commands
+
+  python client.py -c /etc/lxst-client -w /etc/lxst-client/bridge_whitelist.json
+
+  Inside the interactive client:
+    d  Discover channels from whitelist
+    l  List discovered channels
+    <NUM>  Connect to channel at index NUM (1-based)
+    q  Quit
+
+## Initial Setup Order
+
+  1. Ensure ~/.lxst-client or /etc/lxst-client exists
+  2. Place bridge_whitelist.json in either directory (or pass with -w)
+  3. First run creates identity automatically at configdir/identity
+  4. Run `python client.py` then `d` to discover channels
+  5. Messages appear in configdir/lxmf/
+
+## Known quirks
+
+  - If bridge_whitelist.json is missing, client prints an error and returns.
+  - Identity is auto-generated on first run if not present.
+  - Use -v for RNS debug output (path discovery is verbose here).
+  - Path discovery waits up to 10s for relays; increase timeout in client code if needed.