v1.6.0 — Native Notifications, Programmatic API, Watch Mode

🔔 agentrem v1.6.0

The biggest release yet — 6 versions shipped in one night.

Highlights

Native macOS Notifications

• Custom bell icon (no more terminal icon!)
• Priority-based sounds: P1=Hero, P2=Ping, P3=Pop
• Complete ✅ button — tap to mark reminders done right from the notification
• Background watcher daemon: agentrem watch --install (survives reboots)

Programmatic JavaScript API

import { add, check, list, complete, snooze, search, stats } from "agentrem";

await add("Ship feature", { due: "tomorrow", priority: 2 });
const due = await check();
await complete(due[0].id);

check --watch Blocking Mode

# Blocks until a reminder is due, then returns it
agentrem check --watch --json --timeout 60

Perfect for integrating reminders into long-running agent sessions.

Natural Language Dates

agentrem add "Deploy" --due "now"
agentrem add "Review" --due "in 30 minutes"
agentrem add "Ship" --due "tomorrow"

Agent-First Everything

• npx agentrem works with zero install
• Agent-optimized README (code blocks first)
• Landing page: fraction12.github.io/agentrem
• llms.txt + llms-full.txt for agent consumption

Security Hardening

• DB directory: 700 (owner-only)
• Temp files: 600 (owner-only)
• 0 npm audit vulnerabilities
• All SQL parameterized

Stats

• 444 tests passing across 7 test files
• CI green on macOS, Ubuntu, Windows × Node 18, 20, 22
• 3 production dependencies (minimal attack surface)

Full Changelog

v1.3.0 → v1.6.0: Native notifications, Complete button, natural language dates, programmatic API, npx support, check --watch, security hardening, agent-first docs, animated landing page