# 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.

---

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

### Paperless-ngx

- URL: https://docs.home.kies-media.de/
- User: greggy
- Credentials in `.bashrc`/`.profile` (`$PAPERLESS_USER`, `$PAPERLESS_PASS`)
- Dokumenttypen: Rechnungen, Versicherungspolicen, Verträge, wichtige Entscheidungen
- Workflow: Bei Email-Check relevante Dokumente automatisch archivieren

### Google Workspace (gog CLI)

- Version: v0.12.0
- Account: `mkiesewetter9@googlemail.com`
- OAuth authentifiziert für: contacts, calendar
- Keyring-Passwort: `$GOG_KEYRING_PASSWORD` in `.bashrc`/`.profile`
- Befehle:
  - Contacts: `gog contacts list --max 20`
  - Calendar: `gog calendar events primary --account mkiesewetter9@googlemail.com --from <iso> --to <iso>`
  - Kalender-Farben: `gog calendar colors`

### Email (AgentMail)

- Inbox: `max-kies-media-ai-assistent@agentmail.to`
- Name: Max Kies-Media AI Assistent
- API Key: `$AGENTMAIL_API_KEY` in `.bashrc`
- Signatur: "Max von Kies-Media – KI-Assistent von Martin"
- Footer in jeder Email:
  ```
  --
  Martin Kiesewetter
  Tel.: 0176-45853923
  Email: mki@kies-media.de
  ```
- Reply-To: `mki@kies-media.de` verwenden wenn möglich

### Git

- Remote: `https://git.home.kies-media.de/greggy/openclaw.git`
- Branch: `master`
- User: `greggy`
- Workspace Repo: `/root/.openclaw/workspace`
- Credentials in `.bashrc`/`.profile`

### TrueNAS SMB (192.168.8.112)
- Über WireGuard erreichbar: `192.168.8.112`
- Credentials in `.bashrc`: `$TRUENAS_SMB_USER`, `$TRUENAS_SMB_PASS`, `$TRUENAS_SMB_HOST`
- SMB-Credentials-Datei: `/root/.smb-credentials` (für fstab)
- Shares: Filme, ix-applications, martin, isos, Spiele, Programme, Audiobooks, Google, Musik, Familiensachen, Lara, Luisa, openclaw
- SMB-Befehl: `smbclient //$TRUENAS_SMB_HOST/<share> -U $TRUENAS_SMB_USER%$TRUENAS_SMB_PASS`
- Shares auflisten: `smbclient -L $TRUENAS_SMB_HOST -U $TRUENAS_SMB_USER%$TRUENAS_SMB_PASS`

### OpenClaw Arbeitsbereich (TrueNAS)
- SMB-Share: `//192.168.8.112/openclaw` → gemountet auf `/mnt/openclaw-smb`
- Workspace-Spiegel: `/mnt/openclaw-smb/workspace/`
- Auto-Mount via `/etc/fstab` (credentials: `/root/.smb-credentials`)
- Sync-Scripts:
  - `scripts/sync-to-truenas.sh` – synct Workspace zum TrueNAS
  - `scripts/commit-and-sync.sh` – git commit + push + sync zu TrueNAS
- Workflow: Nach Datei-Änderungen → `bash scripts/commit-and-sync.sh`

### Exec-Timeouts (Konventionen)

- Kurze CLI-Abfragen: **150 Sekunden**
- Python-Skripte: **300 Sekunden**
- Browser-Vorgänge: **300 Sekunden**