TOOLS.md - Local Notes

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

Model Selection Policy

When creating tasks, jobs, sub-agents, or hooks, choose the appropriate model:

Model	Use For
Opus 4.5	Everything (default) - best quality, same limits as Sonnet in Max plan
Haiku 4.5	Simple bulk tasks only - news summaries, quick lookups, translations

Default (main session): Opus 4.5 Sonnet 4.5: Not used (Opus has same limits but better quality)

Home Assistant Integration

Webhook endpoint: /hooks/agent
Token: configured in hooks.token
Model: Opus 4.5 (default)

Arrival Hook

When user arrives home, HA calls the webhook. Check memory/arrival-reminders.json for pending reminders and deliver them.

Important: Just send the content directly — no explaining what you're doing (checking files, clearing reminders, etc.). User just wants the info, not the process.

File format for memory/arrival-reminders.json:

{
  "reminders": [
    { "id": "unique-id", "task": "fetch_weather_tomorrow" },
    { "id": "unique-id", "task": "check_calendar_tomorrow" },
    { "id": "unique-id", "message": "Call mom! 📞" }
  ]
}

Use "task" for things that require action (fetch weather, check calendar, look something up)
Use "message" for simple reminders to display as-is
Always include a unique id for each item

CalDAV Calendar Access

Credentials stored in .credentials/nextcloud.env:

URL: https://nextcloud.cloonar.com
User: moltbot@cloonar.com
Calendar: personal_shared_by_dominik.polakovics@cloonar.com

To fetch today's events:

source .credentials/nextcloud.env
curl -s -X REPORT -u "$NEXTCLOUD_USER:$NEXTCLOUD_PASS" \
  -H "Content-Type: application/xml" -H "Depth: 1" \
  -d '<c:calendar-query xmlns:d="DAV:" xmlns:c="urn:ietf:params:xml:ns:caldav"><d:prop><c:calendar-data/></d:prop><c:filter><c:comp-filter name="VCALENDAR"><c:comp-filter name="VEVENT"><c:time-range start="'$(date +%Y%m%d)'T000000Z" end="'$(date +%Y%m%d)'T235959Z"/></c:comp-filter></c:comp-filter></c:filter></c:calendar-query>' \
  "$NEXTCLOUD_URL/remote.php/dav/calendars/$NEXTCLOUD_USER/$CALDAV_CALENDAR/"

Der Standard RSS Summaries

4× daily: 10:00, 14:00, 18:00, 22:00 (Vienna time)
Model: Haiku 4.5
Focus: International politics, technology, science, economics
Excluded: Sports, culture, society

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

2.5 KiB Raw Blame History Unescape Escape