# TOOLS.md — Shay's Environment

## Mac Setup
- Machine: Mac Mini (oliverai account)
- OpenClaw workspace: ~/.openclaw/workspace-oliver

## API Keys (stored in ~/.openclaw/secure)
- OpenRouter: configured
- Tavily: configured
- Ollama: local, port 11434

## Agent Email
- oliveraibot@gmail.com

## GitHub
- Account: oliveraibot-del
- Backup repo: oliver-workspace-backup

## Telegram
- Bot: @MrOliverAIbot
- Group ID: -1003807597926
- Shay's ID: 8724936200

## Models Available
- Claude Sonnet (primary, daily ops)
- Claude Opus (fallback, deep strategy)
- qwen2.5:14b (Scout, local)
- deepseek-r1 (local, reasoning)
- llama3.2:3b (local, lightweight)

## Voice / TTS
Provider: Apple macOS built-in (free)
Command: say -v Samantha "text here"
Available voices: Samantha (default), Karen (AU accent), Daniel (UK)
Recommended: Karen — Australian accent, suits the setup
Usage: Oliver can generate voice briefings using say command
Output: audio plays on Mac speakers or saves to file

## Google Workspace (gog)
Account: oliveraibot@gmail.com
Binary: ~/.local/bin/gog
Auth: configured via OAuth

### Commands
Read inbox: gog gmail search 'newer_than:1d' --max 10
Unread only: gog gmail search 'is:unread newer_than:1d' --max 10
Today's calendar: gog calendar events primary --from $(date -u +%Y-%m-%dT00:00:00Z) --to $(date -u +%Y-%m-%dT23:59:59Z)
Send email: gog gmail send --to [recipient] --subject "[subject]" --body "[body]"

### Rules
- Always require "SEND" confirmation before sending any email
- Check inbox during morning briefing automatically
- Flag any IMPORTANT or UNREAD emails to Shay

## Cost Monitoring
OpenRouter spend check: curl https://openrouter.ai/api/v1/auth/key -H "Authorization: Bearer [key]"
Daily budget alert threshold: $5 warn / $10 critical
Check during morning briefing

## PDF Generation
Script: ~/tools/generate-pdf.sh
Usage: ~/tools/generate-pdf.sh [input.md] [output.pdf]
Service: md-to-pdf.fly.dev (free, no account, no API key)
Zero credits used. Oliver runs this automatically when Shay asks for any document as PDF.