Ai Executive Assistant

AI Executive Assistant

Your personal executive assistant that lives in your terminal. Built on Claude Code.

Manages your day, tracks tasks, preps meetings, and keeps you accountable. Works with your existing tools or completely standalone.

How It Works

The EA has three layers:

• Skills — 13 capabilities that define what the EA can do (morning brief, meeting prep, task capture, etc.)
• Profile — Who you are, how you work, what tools you use, and what the EA should watch for. Generated by /ea-setup.
• Context — The EA's working memory across sessions. Tracks today's plan, weekly goals, monthly focus, velocity, delegations, and decisions.

Skills tell the EA what to do. Your profile tells it how to do it for you specifically. Context files maintain state between conversations.

The Daily Flow

Morning Brief → pulls calendar + tasks + email → today's plan
    ↓
Throughout day → add tasks, delegate, meeting prep as needed
    ↓
Afternoon Check-in → reviews progress → plans tomorrow
    ↓
Nightly Cleanup → organizes backlog → drafts tomorrow's plan
    ↓
Next morning → Morning Brief reads the draft as a head start

What You Get

| Command | What it does | |---------|-------------| | /ea | Talk to your EA — think out loud, get advice, stay on track | | /ea-setup | Personalize your EA — working style, tools, preferences | | /ea-morning-brief | Start your day with an energy-optimized plan | | /ea-checkin | Afternoon review — update progress, plan tomorrow | | /ea-night-cleanup | End-of-day autopilot — organize tasks, draft tomorrow | | /ea-weekly-plan | Monday planning — sprint goal, day-by-day slots | | /ea-weekly-retro | Friday review — patterns, velocity, recommendations | | /ea-monthly-goals | Set 3 focus areas with success criteria | | /ea-add-task | Quick-capture a task (auto-sized, auto-categorized) | | /ea-delegate | Hand off a task with follow-up tracking | | /ea-meeting-prep | Pre-meeting brief — context, open items, questions | | /ea-plan-schedule | Turn a brain dump into an organized schedule |

Quick Start

Prerequisites

• Claude Code installed with an active Anthropic subscription

The Easy Way (Non-Technical)

You don't need to understand any of the code below. Just open Claude Code and tell it:

> "Clone and install this for me: https://github.com/cosmo-autom8s/ai-executive-assistant"

Claude Code will handle the cloning and installation. Once it's done, restart Claude Code so the new commands take effect, then run /ea-setup to personalize your EA. The setup wizard walks you through everything: your working style, energy patterns, goals, and which tools to connect.

After setup, type /ea to start talking to your EA.

Manual Install (Technical)

git clone https://github.com/cosmo-autom8s/ai-executive-assistant.git
cd ai-executive-assistant
./install.sh

Then restart Claude Code so the new commands are available, and run /ea-setup to personalize.

Start Your Day

/ea-morning-brief

Connecting Your Tools (Optional)

The EA works without any tools — it uses local context files and conversation out of the box. But connecting your tools makes it dramatically better.

You can connect:

| Tool Category | What it enables | Examples | |---------------|----------------|----------| | Task Manager | Task tracking, auto-sizing, daily plans from real data | Notion, Todoist, Linear, Asana | | Calendar | Schedule-aware planning, meeting prep, free time detection | Google Calendar, Outlook | | Knowledge Base | Daily context from your notes, energy awareness | Obsidian, Apple Notes | | Email | Morning inbox scan, urgent item flagging | Gmail, Outlook |

How to Connect

The /ea-setup wizard walks you through connecting each tool. You can also add tools anytime by asking Claude Code directly — just say something like "Connect my Notion" or "Add Google Calendar" and it'll guide you.

Under the hood, tools connect via MCP (Model Context Protocol) — an open standard that lets Claude Code talk to external services. If you're comfortable in the terminal, you can add them manually:

# General pattern
claude mcp add [tool-name] -- npx -y @anthropic-ai/claude-code-mcp-[tool-name]

# Examples
claude mcp add notion -- npx -y @anthropic-ai/claude-code-mcp-notion
claude mcp add google-calendar -- npx -y @anthropic-ai/claude-code-mcp-google-calendar

# Search for available tools
claude mcp search [tool-name]

But again — you can just ask Claude Code to do this for you. No need to memorize commands.

Customization

• Personality: Edit ~/.claude/ea-profile.md directly, or re-run /ea-setup
• Skills: Edit any ~/.claude/commands/ea-*.md file to customize behavior
• Add your own: Create new ea-*.md files in ~/.claude/commands/ to extend the EA
• Example profile: See config/example-personality.md for inspiration on what a fully personalized profile looks like

Updating

cd ai-executive-assistant
git pull
./install.sh

This updates all skills to the latest version. Your profile and context files are never overwritten.

Uninstall

cd ai-executive-assistant
./uninstall.sh

You'll be asked whether to keep or remove your profile and context files.

License

MIT — see [LICENSE](LICENSE)

Credits

Built by Cosmin "Cosmo" Lungu. Visit Autom8Lab for more agents, skills, and resources.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: cosmo-autom8s
• Source: cosmo-autom8s/ai-executive-assistant
• License: MIT

Install and usage instructions live in the source repository linked above.