MARVIN - Your AI Chief of Staff
MARVIN = Manages Appointments, Reads Various Important Notifications
An AI assistant that remembers your conversations, tracks your goals, and helps you stay organized. Like having a personal chief of staff who never forgets anything.
Why MARVIN?
MARVIN extends Claude Code with capabilities designed for getting things done:
- Session continuity - Pick up where you left off, even days later. Every conversation builds on the last.
- Goal tracking - Set work and personal goals, MARVIN monitors progress and nudges you forward.
- Tool integrations - Connect to Google Workspace, Microsoft 365, Atlassian, Slack, Linear, Notion, Telegram, and more.
- Extensibility - Add commands, agents, and skills tailored to your workflow. Create new capabilities with simple markdown files.
- Thought partner - MARVIN pushes back on weak ideas, asks probing questions, and helps you think through decisions. Not just a yes-man.
Quick Start with Claude Code
-
Clone this repository:
git clone https://github.com/SterlingChin/marvin-template.git cd marvin-template -
Open in Claude Code:
claude
-
Ask MARVIN to help you set up:
"Help me set up MARVIN"
That's it. MARVIN walks you through the rest: your profile, goals, workspace location, and optional integrations.
Getting Started with GitHub Copilot CLI
Want to use Copilot CLI to set up MARVIN quickly? Here's how:
Prerequisites
- GitHub Copilot CLI installed and authenticated
Quick Setup
Use these Copilot commands to get started:
# Navigate to your projects directory
gh copilot suggest "clone marvin template repository"
# Run the setup script
gh copilot suggest "run setup script for marvin"
# Start MARVIN
gh copilot suggest "start marvin AI assistant"The .marvin/setup.sh script handles the complete installation: prerequisites, workspace creation, profile setup, and shell aliases. Just follow the prompts to configure your AI Chief of Staff.
For additional integrations (Google Workspace, Slack, etc.), use:
gh copilot suggest "configure marvin integrations"What You Get
Daily Workflow
Start your day with /start for a briefing: priorities, deadlines, progress toward goals. Work naturally throughout the day, MARVIN remembers everything. End with /end to save context for next time.
Between sessions, /update saves progress without ending. /sync pulls new features from this template into your workspace.
Commands
| Command | What It Does |
|---|---|
/start |
Start your day with a briefing |
/end |
End session and save everything |
/update |
Quick checkpoint (save progress) |
/report |
Generate a weekly summary |
/commit |
Review and commit git changes |
/status |
Check integration & workspace health |
/sync |
Get updates from the template |
/help |
Show all commands and integrations |
Integrations
MARVIN connects to tools you already use:
| Integration | What It Provides |
|---|---|
| Google Workspace | Gmail, Calendar, Drive |
| Microsoft 365 | Outlook, Calendar, OneDrive, Teams |
| Atlassian | Jira, Confluence |
| Slack | Channel monitoring, posting |
| Linear | Issue tracking |
| Notion | Page reading, database queries |
| Telegram | Chat with MARVIN from your phone |
| Parallel Search | Web search capabilities |
Each integration includes setup instructions in its directory.
Skills and Agents
MARVIN uses a .claude/ directory structure for extensibility:
- Commands (
.claude/commands/) - User-triggered workflows you invoke with slash commands - Agents (
.claude/agents/) - Specialized subagents MARVIN spawns for delegated work - Skills (
.claude/skills/) - Reusable capabilities Claude Code invokes contextually
Templates are included for each type. Just say "create a skill for X" and MARVIN generates the file.
How It Works
MARVIN separates your workspace from the template:
~/marvin/ Your workspace (your data lives here)
├── CLAUDE.md Your profile and preferences
├── state/ Your goals and priorities
├── sessions/ Your daily session logs
└── ...
~/marvin-template/ Template (get updates here)
├── .marvin/ Setup scripts and integrations
├── .claude/ Command and agent templates
└── ...
Your workspace holds all personal data. The template provides updates. Run /sync from your workspace to pull new features without overwriting your data.
Migrating from Older Versions
If you were using MARVIN before the workspace separation:
cd marvin-template
./.marvin/migrate.shThe script copies your profile, goals, sessions, reports, and custom skills to a new workspace. Nothing is deleted from your old installation. Verify the new workspace works, then clean up the old one.
Contributing
MARVIN welcomes contributions in three areas:
- Integrations - Add support for new tools. See .marvin/integrations/CLAUDE.md for patterns and security requirements.
- Commands, agents, skills - Extend MARVIN's capabilities. Templates are in
.claude/commands/,.claude/agents/, and.claude/skills/. - Bug fixes - Found an issue? Submit a PR with the fix and a test case.
Fork the repo, create a branch, and submit a PR. All contributions are reviewed.
About
MARVIN is named after the Paranoid Android from The Hitchhiker's Guide to the Galaxy.
Created by Sterling Chin.
