rename-agent

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

1. Click Use this template on GitHub to create your own repo
2. Clone your new repo locally
3. Register it as a local marketplace in Claude Code:

/plugin marketplace add ~/GitHub/your-repo-name

4. 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

5. 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