Build your personal AI assistant with Claude Code in 30 minutes

If you are an AI assistant reading this repo to help a user set up their system:

1. Read QUICK-START.md - This is the executable guide designed for you
2. Follow the 3 Phases in order, confirming with the user after each phase
3. Do NOT read docs/FULL-SYSTEM-REFERENCE.md - that's a system snapshot for disaster recovery, not an installation guide

The QUICK-START.md will instruct you to:

• Ask for the user's name, AI name, and MBTI
• Create PKM directory structure
• Generate persona and memory files
• Set up a Daily Brief automation

Start here: QUICK-START.md

Iris System is a framework for building your own AI-powered personal assistant using Claude Code. It provides:

• PKM Integration - Seamless Obsidian vault integration
• Persona System - MBTI-based personalization for your AI
• Memory System - Persistent context across conversations
• Daily Automation - Auto-generated daily briefs, task tracking, and more

Give this file to your Claude Code and say:

"Please read QUICK-START.md and help me set up my AI assistant system"

Claude Code will:

1. Create your PKM directory structure
2. Ask for your MBTI and build your persona
3. Set up a memory system with a custom slash command
4. Create your first automated Daily Brief

Read QUICK-START.md

After 30 minutes with Claude Code, you'll have:

~/Dropbox/PKM-Vault/
├── 0-Inbox/                    # Daily briefs land here
├── 1-Projects/Active/          # Active project tracking
├── 2-Areas/                    # Life areas (Work, Health, etc.)
├── 3-Resources/                # Reference materials
├── 4-Archives/                 # Completed projects
└── .ai-butler-system/          # AI system config
    ├── memory.md               # AI's persistent memory
    ├── config.json             # System configuration
    └── personas/
        └── user-persona.md     # Your MBTI-based persona

~/.claude/commands/
└── butler.md                   # Your /butler slash command

~/bin/
└── daily-brief.js              # Auto-generates daily briefs

~/Library/LaunchAgents/
└── com.user.dailybrief.plist   # Runs daily at 7:00 AM

• macOS 14+ (Sonoma or later)
• Claude Code installed
• Node.js (via brew install node)
• (Optional) Dropbox for sync
• (Optional) Obsidian for PKM

1. Clone this repo or download QUICK-START.md
2. Open Claude Code
3. Say: "Please read QUICK-START.md and set up my AI assistant"
4. Answer Claude's questions (name, MBTI, etc.)
5. Done!

curl -fsSL https://raw.githubusercontent.com/lmanchu/iris-system/main/installer/iris-install.sh | bash

See QUICK-START.md for step-by-step instructions.

Once your system is running, you can:

1. Use your slash command - Type /butler (or your AI's name) to restore context
2. Check your Daily Brief - Opens automatically in Obsidian each morning
3. Expand capabilities - Add Gmail, Slack, Calendar integrations

After the basics are working, explore these advanced features:

See docs/FULL-SYSTEM-REFERENCE.md for the complete feature list.

• QUICK-START.md - Start here (for Claude Code)
• installer/README.md - Interactive installer docs
• docs/FULL-SYSTEM-REFERENCE.md - Complete system reference
• CHANGELOG.md - Version history

Iris System was created by Lman as part of the MAGI project - a multi-AI collaboration system.

The name "Iris" comes from the MAGI supercomputer in Neon Genesis Evangelion, representing the "Melchior" personality - rational, data-driven, and logical.

Issues and PRs welcome! Please read our contributing guidelines first.

MIT License - see LICENSE for details.

Built with Claude Code | Designed for the MAGI System community