Ceo Task System

CEO Task System

A multi-agent TypeScript system that captures raw thoughts via Apple Shortcuts, enriches them into structured tasks using Claude AI, and syncs across email, Google Calendar, Slack, and Google Sheets.

What it does

• Exposes a Fastify webhook that Apple Shortcuts POSTs voice/text notes to
• Runs an enrichment pipeline (Claude) to parse, classify, and structure raw input into actionable tasks
• Polls an IMAP mailbox to extract task-relevant emails
• Syncs tasks and appointments to Google Calendar and Google Sheets
• Processes Slack threads via a Q&A agent

Stack

• Runtime: Node.js + TypeScript
• Webhook server: Fastify
• AI: Anthropic Claude (@anthropic-ai/sdk)
• Integrations: Gmail (IMAP), Google Calendar, Google Sheets, Slack
• Testing: Vitest
• Logging: Pino

Project structure

src/
  agents/
    enrichment-pipeline.ts   # Claude-powered task enrichment
    mail/                    # IMAP polling + email parsing
    slack/                   # Slack Q&A processor
    sheets/                  # Google Sheets sync
    appointment/             # Calendar scheduling
  webhooks/server.ts         # Fastify server (Apple Shortcuts entry point)
  memory/simple-storage.ts   # File-based task persistence
  shared/                    # Config, types, logger
tests/                       # Vitest unit tests

Setup

npm install
cp .env.example .env
# Fill in your API keys (see .env.example)
npm run dev

Environment variables

See `.env.example` for the full list. Key variables:

Variable	Description
ANTHROPIC_API_KEY	Claude API key
IMAP_HOST / USER / PASSWORD	Gmail IMAP credentials
GOOGLE_CLIENT_ID / SECRET	OAuth for Calendar + Sheets
WEBHOOK_SECRET	Fastify webhook auth