Skillget

iris-system

skill
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Fail
  • fs.rmSync — Destructive file system operation in .claude/skills/gstack/browse/src/cli.ts
  • process.env — Environment variable access in .claude/skills/gstack/browse/src/cli.ts
  • network request — Outbound network request in .claude/skills/gstack/browse/src/cli.ts
  • fs.rmSync — Destructive file system operation in .claude/skills/gstack/browse/src/server.ts
  • process.env — Environment variable access in .claude/skills/gstack/browse/src/server.ts
  • fs.rmSync — Destructive file system operation in .claude/skills/gstack/browse/test/commands.test.ts
  • process.env — Environment variable access in .claude/skills/gstack/browse/test/commands.test.ts
  • network request — Outbound network request in .claude/skills/gstack/browse/test/test-server.ts
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This project is a framework for building a personalized AI assistant using Claude Code. It sets up a Personal Knowledge Management (PKM) directory structure, persistent memory, and daily automation scripts to integrate with tools like Obsidian.

Security Assessment
Overall Risk: Medium. The codebase contains several security concerns that require caution. The scan flagged multiple instances of destructive file system operations (`fs.rmSync`) in its CLI, server, and test files, meaning the tool has the capability to permanently delete files on your machine. It also reads environment variables and makes outbound network requests. While no hardcoded secrets or dangerous explicit permissions were detected, the combination of file deletion, environment access, and network calls means you should carefully review the code before granting it access to your local system.

Quality Assessment
The project is actively maintained, with its most recent push occurring today. It uses the permissive and standard MIT license. However, it suffers from very low community visibility, currently sitting at only 6 GitHub stars. Because of this limited adoption, there is little evidence of broader community testing or auditing, so you will be relying primarily on the original author's code.

Verdict
Use with caution — while actively maintained and open-source, the inclusion of destructive file operations paired with low community adoption warrants a thorough review of the code before executing it locally.
SUMMARY

🧠 AI Personal Assistant System built with Claude Code - Complete documentation of the MAGI System architecture and Iris development methodology

README.md

Iris System

Build your personal AI assistant with Claude Code in 30 minutes

License: MIT
Made with Claude Code

For AI Agents (Claude Code, Cursor, etc.)

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

What is Iris System?

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

Quick Start (New Users)

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

What You'll Get

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

Requirements

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

Installation Options

Option 1: Let Claude Code Do It (Recommended)

  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!

Option 2: Interactive Installer

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

Option 3: Manual Setup

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

After Setup

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

Extending Your System

After the basics are working, explore these advanced features:

Feature What It Does Difficulty
Gmail MCP Email summaries in Daily Brief Easy
Google Calendar MCP Today's events auto-loaded Easy
Slack MCP Team message summaries Medium
Investment Tracker Stock/crypto monitoring Medium
Twitter Automation Auto-engagement Advanced
Task Queue Multi-machine sync Advanced

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

Documentation

About

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.

Contributing

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

License

MIT License - see LICENSE for details.

Built with Claude Code | Designed for the MAGI System community

Reviews (0)

No results found