Carlton

A daily meeting briefing assistant. Fetches your calendar across multiple Google accounts, researches each meeting (across Gmail, Calendar, Drive), and emails you a briefing.

Read-only and isolated. Carlton uses Resend for email delivery, separate from Google auth. Carlton can send email to you, not as you.

Prerequisites

Bun — runtime and package manager
Claude Code — npm install -g @anthropic-ai/claude-code
Google Cloud OAuth credentials — for Calendar, Gmail, and Drive API access
Resend API key — for sending briefings to you

Setup

git clone https://github.com/smcllns/carlton.git && cd carlton
bun install
bun link                                # Makes `carlton` available globally

# Google OAuth
bun carlton credentials                 # Register your OAuth JSON from credentials/
bun carlton accounts add [email protected]  # Opens browser for OAuth
bun carlton setup                       # Verify everything works

# Email delivery
cp .env.example .env                    # Add your RESEND_API_KEY

Edit PROMPT.md to configure your accounts, delivery address, and briefing preferences. Run bun carlton auth for detailed setup instructions.

Usage

carlton send                         # Research + send briefing for tomorrow
carlton send 2026-02-10              # Same, for specific date
carlton send --test                  # Nuke date folder, full fresh run
carlton [date]                       # List events (no research/send)
carlton reset                        # Wipe all reports (keeps auth)
carlton help                         # Show all commands

send runs a single Claude agent that researches your meetings and produces the briefing, then sends it via email. One command, fully automated.

Output goes to reports/YYYY-MM-DD/.

Security

Google access is read-only. Only search, list, get methods are used. test/safety.test.ts scans all source files for forbidden write calls.
Email delivery is isolated from Google auth. Resend sends as Carlton, not as you. email.ts cannot import google.ts (enforced by safety tests).

Architecture

PROMPT.md (config)
    ↓
fetch calendar events (gccli)
    ↓
single Claude agent researches meetings (using gmcli, gccli, gdcli)
    ↓ produces briefing markdown to stdout
write reports/<date>/briefing.md → email via Resend

Module	Purpose
`src/index.ts`	CLI entry point and commands
`src/prompt.ts`	PROMPT.md parser
`src/calendar.ts`	Multi-account event fetching + dedup
`src/briefing.ts`	Single agent: research + briefing
`src/email.ts`	Resend email delivery
`src/google.ts`	Wrappers for gccli, gmcli, gdcli
`src/config.ts`	Path helpers

Testing

bun test    # Unit + safety tests

Skill Version

An alternative implementation lives in skill/ that runs the same pipeline as a Claude Code skill instead of a TypeScript app. Simpler to set up but less deterministic — Claude may not fetch as many details exhaustively as the app version, unless you specify those details in PROMPT.md. See skill/compare-skill-vs-app-approaches.md for tradeoffs.

smcllns/carlton

README