From 55d58535d605737f455cd5f2be8983bc185ad8a8 Mon Sep 17 00:00:00 2001
From: "Rodrigo Rodriguez (Pragmatismo)" <me@rodrigorodriguez.com>
Date: Thu, 9 Apr 2026 23:27:08 -0300
Subject: [PATCH] Update docs: add LOAD_ONLY env and MinIO drive access tips

---
 AGENTS.md | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 59 insertions(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index dc176cf..e716dd4 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -42,7 +42,8 @@
 └── (compilação fica em memória ou /opt/gbo/work/ se existir)
 ```
 
-**IMPORTANTE:** 
+**IMPORTANTE:**
+- **Work folder (dev):** `./botserver-stack/data/system/work` mirrors `/opt/gbo/data` for local development. Keep it in sync when editing bot files. 
 - **FONTE**: `/opt/gbo/data/{bot}.gbai/{bot}.gbdialog/{tool}.bas`
 - **DEV LOCAL**: `./botserver-stack/data/system/work/{bot}.gbai/{bot}.gbdialog/`
 - O botserver compila `.bas` → `.ast` automaticamente
@@ -349,6 +350,18 @@ curl http://localhost:8080/health
 ./restart.sh                        # Restart services
 ```
 
+### LOAD_ONLY Environment Variable
+Use `LOAD_ONLY` in `/opt/gbo/bin/.env` to filter which bots are loaded and monitored:
+
+```bash
+# Example: only load default and salesianos bots
+LOAD_ONLY=default,salesianos
+```
+
+This applies to both:
+1. Bot discovery (auto-creating bots from S3 buckets)
+2. DriveMonitor (syncing config.csv)
+
 ---
 
 ## 🎭 Playwright Browser Testing
@@ -658,6 +671,51 @@ curl -s -X POST \
 
 ## 📊 SEPLAGSE Bot Configuration
 
+### Drive (MinIO) Access - Production
+
+**Quick Access:**
+```bash
+# SSH to the host server
+ssh administrator@63.141.255.9
+
+# Access drive container
+sudo incus exec drive -- bash
+
+# List all buckets
+/opt/gbo/bin/mc ls local/
+
+# Access specific bucket
+/opt/gbo/bin/mc alias set local2 http://127.0.0.1:9100 gbadmin "Pesquisa@1000"
+/opt/gbo/bin/mc ls local2/
+```
+
+**Credentials (from drive container):**
+- Check `/root/.mc/config.json` or `/opt/gbo/conf/minio.json`
+- Default: `gbadmin` / `Pesquisa@1000` on port **9100** (not 9000!)
+- Port 9100 is the MinIO console/API in this setup
+
+**Common Operations:**
+```bash
+# List bucket contents
+/opt/gbo/bin/mc ls local2/default.gbai/
+
+# Create new bucket
+/opt/gbo/bin/mc mb local2/newbot.gbai
+
+# Copy files between buckets
+/opt/gbo/bin/mc cp --recursive local2/gbo-oldbot.gbai/somefolder local2/newbot.gbai/
+
+# Rename/move bucket (must copy + delete):
+/opt/gbo/bin/mc cp --recursive local2/gbo-old.gbai/* local2/old.gbai/
+/opt/gbo/bin/mc rb local2/gbo-old.gbai
+```
+
+**Tips:**
+- MinIO runs on port 9100 in this container setup (not 9000)
+- mc config is at `/root/.mc/config.json` in the drive container
+- Always use `--recursive` flag for moving/copying buckets
+- Bot buckets should be named `{botname}.gbai` (no gbo- prefix needed)
+
 ### Bot Location
 - **Source**: `/opt/gbo/data/seplagse.gbai/seplagse.gbdialog/`
 - **Work**: `./botserver-stack/data/system/work/seplagse.gbai/seplagse.gbdialog/`