TOOLS.md

Editor⌘S per salvare

# TOOLS.md - Local Notes

Skills define _how_ tools work. This file is for _your_ specifics — the stuff that's unique to your setup.

## What Goes Here

Things like:

- Camera names and locations
- SSH hosts and aliases
- Preferred voices for TTS
- Speaker/room names
- Device nicknames
- Anything environment-specific

## Examples

```markdown
### Cameras

- living-room → Main area, 180° wide angle
- front-door → Entrance, motion-triggered

### SSH

- home-server → 192.168.1.100, user: admin

### TTS

- Preferred voice: "Nova" (warm, slightly British)
- Default speaker: Kitchen HomePod
```

## Why Separate?

Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.

---

## Slack DM Channels

- **Emiliano** → D0463FF085D (U0457460AF3)
- **Beatrice** → D08UDQ298BW (U08Q14S2CCR)
- **Alessandro** → D06QUF1GQ5R (U06QP7D8BRN)
- **Michele** → D07V37KPDA4 (U04C67D23BR)
- **Francesca Franzoni** → D094AQ57G3H (U090D3ZN6AX)

**Lorenzo's Slack ID:** U024J1CNNM7

---

## Smart Life / Tuya

**Script:** `~/.openclaw/workspace/tuya/smartlife.js`

**Dispositivi:**
- `soggiorno` → Lampada soggiorno (bffcedcca51e3a1771mmpg)
- `heater` / `stufa` → Vonroc Smart Heater (bf48fee1d8278b3448hqb2)
- `scale` → Lampada scale (bf3c10f10511831645lzhp)
- `checco1` → Luce camera checco 1 (bfd6311cf1febc52c6bmzi)
- `checco2` → Luce camera checco 2 (bf8f252a74c6e8c5fbz7cc)

**Comandi:**
```bash
node tuya/smartlife.js list              # Lista dispositivi
node tuya/smartlife.js on stufa          # Accendi stufa
node tuya/smartlife.js off stufa         # Spegni stufa
node tuya/smartlife.js temp 22           # Imposta stufa a 22°C
node tuya/smartlife.js status heater     # Stato dispositivo
```

---

## Image Handling

**Limite API Claude:** Le immagini nei tool result non possono superare **5MB**.

**Procedura prima di mostrare un'immagine:**
1. Controlla dimensione con `ls -l` o `stat`
2. Se > 4MB, comprimi/ridimensiona con ImageMagick:
   ```bash
   # Ridimensiona mantenendo aspect ratio (max 2000px lato lungo)
   magick input.jpg -resize 2000x2000\> -quality 85 output.jpg
   
   # Oppure comprimi solo qualità
   magick input.jpg -quality 75 output.jpg
   ```
3. Solo dopo usa `read` per mostrarla

**Mai** leggere direttamente immagini grandi senza prima verificare/comprimere.

---

## Gog (Google Workspace CLI)

**Archiviare email (rimuovi da inbox):**
```bash
# ❌ SBAGLIATO — "archive" non è un comando gog
gog gmail archive <id>

# ✅ CORRETTO — rimuovi label INBOX
gog gmail messages modify <id> --remove-labels INBOX --account lorenzo@wearefutura.com
```

**Comandi utili:**
```bash
gog gmail search "is:unread" --max 50 --account lorenzo@wearefutura.com
gog gmail get <id> --account lorenzo@wearefutura.com
gog gmail messages modify <id1> <id2> --remove-labels INBOX --account lorenzo@wearefutura.com
```

---

Add whatever helps you do your job. This is your cheat sheet.

Preview

TOOLS.md - Local Notes

Skills define how tools work. This file is for your specifics — the stuff that's unique to your setup.

What Goes Here

Things like:

Camera names and locations
SSH hosts and aliases
Preferred voices for TTS
Speaker/room names
Device nicknames
Anything environment-specific

Examples

### Cameras

- living-room → Main area, 180° wide angle
- front-door → Entrance, motion-triggered

### SSH

- home-server → 192.168.1.100, user: admin

### TTS

- Preferred voice: "Nova" (warm, slightly British)
- Default speaker: Kitchen HomePod

Why Separate?

Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.

Slack DM Channels

Emiliano → D0463FF085D (U0457460AF3)
Beatrice → D08UDQ298BW (U08Q14S2CCR)
Alessandro → D06QUF1GQ5R (U06QP7D8BRN)
Michele → D07V37KPDA4 (U04C67D23BR)
Francesca Franzoni → D094AQ57G3H (U090D3ZN6AX)

Lorenzo's Slack ID: U024J1CNNM7

Smart Life / Tuya

Script: ~/.openclaw/workspace/tuya/smartlife.js

Dispositivi:

soggiorno → Lampada soggiorno (bffcedcca51e3a1771mmpg)
heater / stufa → Vonroc Smart Heater (bf48fee1d8278b3448hqb2)
scale → Lampada scale (bf3c10f10511831645lzhp)
checco1 → Luce camera checco 1 (bfd6311cf1febc52c6bmzi)
checco2 → Luce camera checco 2 (bf8f252a74c6e8c5fbz7cc)

Comandi:

node tuya/smartlife.js list              # Lista dispositivi
node tuya/smartlife.js on stufa          # Accendi stufa
node tuya/smartlife.js off stufa         # Spegni stufa
node tuya/smartlife.js temp 22           # Imposta stufa a 22°C
node tuya/smartlife.js status heater     # Stato dispositivo

Image Handling

Limite API Claude: Le immagini nei tool result non possono superare 5MB.

Procedura prima di mostrare un'immagine:

Controlla dimensione con ls -l o stat

Se > 4MB, comprimi/ridimensiona con ImageMagick:

# Ridimensiona mantenendo aspect ratio (max 2000px lato lungo)
magick input.jpg -resize 2000x2000\> -quality 85 output.jpg

# Oppure comprimi solo qualità
magick input.jpg -quality 75 output.jpg

Solo dopo usa read per mostrarla

Mai leggere direttamente immagini grandi senza prima verificare/comprimere.

Gog (Google Workspace CLI)

Archiviare email (rimuovi da inbox):

# ❌ SBAGLIATO — "archive" non è un comando gog
gog gmail archive <id>

# ✅ CORRETTO — rimuovi label INBOX
gog gmail messages modify <id> --remove-labels INBOX --account [email protected]

Comandi utili:

gog gmail search "is:unread" --max 50 --account [email protected]
gog gmail get <id> --account [email protected]
gog gmail messages modify <id1> <id2> --remove-labels INBOX --account [email protected]

Add whatever helps you do your job. This is your cheat sheet.