Chief-of-Staff Plugin Template
A template for building your own Claude Code personal assistant plugin. Includes a full-featured email orchestrator, travel agent, credit card tracker, and file renamer as working examples.
Getting Started
- Click Use this template on GitHub to create your own repo
- Clone your new repo locally
- Register it as a local marketplace in Claude Code:
/plugin marketplace add ~/GitHub/your-repo-name
- Install the plugins you want:
/plugin install chief-of-staff@my-plugins
/plugin install travel-agent@my-plugins
/plugin install credit-card-benefits@my-plugins
/plugin install rename-agent@my-plugins
- Customize the plugins, add your own agents, and make it yours.
Note: The marketplace name (my-plugins) comes from the name field in .claude-plugin/marketplace.json. Change it to whatever you like.
Building MCP Servers
If plugins include bundled MCP servers, run the setup script:
./setup.sh
Included Plugins
chief-of-staff
The email orchestrator. Self-learning email triage that classifies your inbox, suggests actions based on your patterns, and delegates to specialized sub-agents.
Why Chief-of-Staff?
- Questions-first flow: Collect ALL decisions up front, execute in bulk at the end (faster)
- Learns your patterns: Records your choices vs suggestions, improves accuracy over time
- Routes intelligently: Detects packages, newsletters, and action items, sends them to the right handler
- Multiple modes: Interview mode (voice-friendly), batch mode (visual HTML), digest mode (summaries)
- Unified interface: One plugin, many capabilities
Quick Start
# 1. Configure your email provider
/chief-of-staff:setup
# 2. Learn patterns from existing folders
/chief-of-staff:learn
# 3. Triage your inbox
/chief-of-staff:triage # Interactive Q&A mode
# OR
/chief-of-staff:batch # Visual HTML batch mode
Commands
| Command | Description |
|---|
/chief-of-staff:setup | Configure email provider (Fastmail, Gmail, Outlook) |
/chief-of-staff:daily | Full daily orchestration routine |
/chief-of-staff:status | Quick dashboard of inbox status |
/chief-of-staff:triage | Interactive questions-first triage |
/chief-of-staff:batch | Visual HTML batch interface |
/chief-of-staff:parcel | Process shipping emails to Parcel app |
/chief-of-staff:reminders | Create reminders from action items |
/chief-of-staff:unsubscribe | Unsubscribe from newsletters |
/chief-of-staff:digest | Summarize automated emails |
/chief-of-staff:learn | Bootstrap or update filing rules |
/chief-of-staff:analyze | Find patterns in Trash/Archive |
/chief-of-staff:optimize | Deep folder analysis and suggestions |
/chief-of-staff:rules | View/manage filing rules |
Triage Modes
| Mode | Best For | How It Works |
|---|
/chief-of-staff:triage | Mobile, voice, thorough review | One-by-one Q&A with structured options |
/chief-of-staff:batch | Desktop, quick visual review | HTML interface, review all at once |
/chief-of-staff:digest | Quick status | Summary of automated emails |
Interview Mode Flow
PHASE 1: COLLECT (rapid Q&A)
-> Answer questions for each email
-> No waiting between emails
PHASE 2: EXECUTE (bulk processing)
-> All actions run at once
-> Single API call per folder
PHASE 3: LEARN (improve suggestions)
-> Record decisions vs suggestions
-> Update confidence scores
Built-in Sub-Agents
| Agent | Purpose |
|---|
inbox-interviewer | Interactive questions-first triage |
inbox-to-parcel | Package tracking from shipping emails |
inbox-to-reminder | Create reminders from action items |
newsletter-unsubscriber | Unsubscribe from newsletters |
digest-generator | Summarize automated emails |
organization-analyzer | Analyze Trash/Archive patterns |
pattern-learner | Bootstrap filing rules from folders |
folder-optimizer | Suggest folder reorganization |
decision-learner | Learn from triage decisions |
batch-html-generator | Visual batch triage interface |
batch-processor | Execute batch triage decisions |
imessage-assistant | Read and send iMessages via CLI |
Email MCP Setup (Required)
Chief-of-Staff does NOT bundle an email MCP server. You must configure your email provider separately.
Fastmail (Recommended)
Deploy your own Fastmail MCP server using Cloudflare Workers:
Repository: omarshahine/fastmail-mcp-remote
# After deploying, add to Claude Code:
claude mcp add --transport http fastmail https://your-worker.workers.dev/mcp
Gmail
