🧑‍💼 Personal AI Chief of Staff

📸 Demo

╭──────────────────────────────────────────────────────────────╮
│ Personal AI Chief of Staff │
│ Agent for: Talha (Software Engineer) │
│ Mode: DRY RUN | TZ: Asia/Karachi │
╰──────────────────────────────────────────────────────────────╯
📬 Fetching emails...
✓ Fetched 5 emails.
📅 Fetching calendar...
✓ Fetched 4 calendar events.
🧠 Triaging emails...
 ✓ Triaged 5 emails.
✅ Extracting tasks...
 ✓ Extracted 7 tasks.
📋 Generating morning brief...
╭──────────────────────────────────────────────────────────────╮
│ Good morning, Talha! Big day ahead — 4 meetings, 2 urgent │
│ items, and an interview to wrap up. Let's get after it. │
╰──────────────────────────────────────────────────────────────╯
📅 Schedule
 10:00 AM Daily Standup ali, zara, hamza...
 11:00 AM Sprint Planning team@company.com
 02:00 PM 1:1 with Sarah sarah@company.com
 04:00 PM Interview — Farhan K. hr, farhan.k
✅ Priority Tasks
 🔴 Submit interview feedback for Farhan K. due: 3:00 PM
 🔴 Complete Q2 self-assessment form due: Friday EOD
 🟠 Process Invoice #4521 payment (450ドル) due: Apr 19
 🟡 Prepare talking points for 1:1 with Sarah today
 🟢 Review standup notes — Ali blocked on DB creds this week
📬 Email Actions
 ✉️ reply Sarah Manager Q2 Performance Review — Action Required U
 🚩 flag HR Team Interview feedback needed — Farhan K. U
 📦 archive Slack Bot Team standup notes — April 16 N
 📦 archive TechBrief Weekly newsletter: AI tools roundup L
⏰ Focus Block: 12:00–1:30 PM between sprint planning and your 1:1
👀 Watch Out For
 • Interview feedback deadline is 3 PM — don't miss it
 • Ali is blocked on DB creds — may need your help
⚡ Quick Wins
 • Mark standup notes as read
 • Forward invoice #4521 to accounts
 • Check if DB creds issue is in your scope
✓ Chief of Staff run complete!

🧠 How It Works

┌──────────────┐ ┌──────────────┐ ┌─────────────────────────┐
│ 1. FETCH │──▶│ 2. FETCH │──▶│ 3. TRIAGE (Claude) │
│ │ │ │ │ │
│ Gmail API │ │ Google Cal │ │ Reads all emails │
│ Last 24h │ │ Today's │ │ Decides: reply/flag/ │
│ Unread + │ │ events │ │ archive/ignore │
│ Important │ │ │ │ Drafts replies │
└──────────────┘ └──────────────┘ └─────────────────────────┘
 │
 ▼
┌──────────────┐ ┌──────────────┐ ┌─────────────────────────┐
│ 6. DELIVER │◀──│ 5. APPLY │◀──│ 4. SYNTHESIZE (Claude) │
│ │ │ │ │ │
│ Slack brief │ │ Create │ │ Extract tasks │
│ Markdown │ │ Gmail drafts│ │ Prioritize day │
│ file saved │ │ Archive │ │ Generate brief │
│ Terminal │ │ emails │ │ Find focus block │
└──────────────┘ └──────────────┘ └─────────────────────────┘

✨ Features

🗂️ Project Structure

chief-of-staff/
├── main.py # CLI entry point
├── config.py # Config, env vars, Pydantic models
├── requirements.txt
├── .env.example
├── SETUP.md # Google OAuth setup guide
│
├── agent/
│ ├── brain.py # Claude: email triage, tasks, brief
│ └── orchestrator.py # Main agentic loop
│
├── tools/
│ ├── gmail_tool.py # Gmail API: read, draft, archive
│ ├── calendar_tool.py # Google Calendar API: read, create
│ ├── slack_tool.py # Slack: deliver brief
│ └── reporter.py # Terminal + Markdown brief printer
│
└── data/
 ├── briefs/ # Saved daily briefs (auto-generated)
 ├── emails/ # Email cache
 └── google_token.json # OAuth token (auto-generated on first run)

🚀 Quickstart

1. Clone & install

git clone https://github.com/yourusername/personal-ai-chief-of-staff.git
cd personal-ai-chief-of-staff
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. Configure

cp .env.example .env

3. Set up Google API

4. Run dry run first (safe — no emails sent)

python main.py --dry-run

5. Go live

python main.py --live

⚙️ CLI Reference

python main.py [OPTIONS]
Options:
 --dry-run Simulate — no emails sent, no Slack messages (default)
 --live Actually create drafts and post to Slack
 --schedule Daemon mode — runs daily at BRIEF_HOUR in .env
 --emails-only Only triage emails, skip brief generation
 --brief-only Generate brief without applying email actions
Examples:
 python main.py --dry-run # safe test
 python main.py --live # full live run
 python main.py --schedule --live # run every morning automatically

🔑 API Keys & Cost

🛠️ Customization

Change what Claude focuses on

# Add to the triage prompt:
"Always flag emails from my CEO (ceo@company.com) as urgent.
Never draft replies to newsletters.
If an email contains an invoice, always flag it as high priority."

Add more integrations

🤝 Contributing

📄 License

🙋 Author