rolodex v0.4.0

Download and add to an agent

This release includes a ready-to-run package (rolodex-0.4.0.tgz, attached
below) — no build step needed, just extract, install its 3 dependencies,
and point your agent host at it.

tar xzf rolodex-0.4.0.tgz
cd package
npm install --omit=dev

Then add it to your MCP host's config. For Claude Desktop
(claude_desktop_config.json):

{
  "mcpServers": {
    "rolodex": {
      "command": "node",
      "args": ["--experimental-sqlite", "/absolute/path/to/package/dist/mcp/server.js"],
      "env": { "ROLODEX_DB": "/absolute/path/to/wherever/you/want/rolodex.db" }
    }
  }
}

Restart your agent host and it will have 5 real tools: rolodex_upsert,
rolodex_search, rolodex_followups, rolodex_log_interaction,
rolodex_sync_google. .claude/skills/rolodex/SKILL.md
teaches an agent how to use them well, if your host supports skills.

The same package also runs the full standalone app (npm run shell) —
see README.md.

---

[0.4.0] - 2026-08-12

Changed

• google-oauth-flow release finalization. Applied the planned minor version bump (0.3.0 → 0.4.0) for the real Google OAuth consent flow.

Added

• A real Google OAuth 2.0 "loopback IP address" consent flow (src/lib/google-oauth-flow.ts) — the current Google-required mechanism for a Desktop-app client, replacing the dead out-of-band flow. Google sync is now actually reachable by a real user: the wizard's Google-connect step completes a real sign-in instead of stopping at a placeholder, and a token refreshed during a routine sync is now persisted back to the keychain instead of silently re-derived every time.
• A working Cancel button on the wizard's Google-connect step, genuinely tearing down the local OAuth listener instead of running out a 120-second timeout.
• A "Reconnect Google" action in the shell's settings popover, for re-establishing a revoked/expired connection without rerunning the first-run wizard.