v0.7.0: Security, Skills, and Infrastructure Hardening

What's New in v0.7.0

Major release with 18 commits of improvements since v0.6.0.

🔒 Security

• Comprehensive prompt injection and input validation guidance
• Security hardening for art skill (removed Discord/Midjourney integration)

✨ New Skills

• BrightData - Four-tier progressive web scraping skill with complete MCP installation docs
• Art - PAI visual aesthetic system (Tron + Anthropic + Excalidraw fusion)
• Story-explanation - Narrative summary generation
• System-createskill and system-createcli - Meta-skills for building skills and CLIs

🏗️ Infrastructure

• PAI_DIR wrapper and protection system
• PAI vs Kai clarity documentation
• Comprehensive event capture hook system
• Complete MCP installation instructions

📚 Documentation

• Fixed all broken documentation links and references
• CORE skill is now the canonical documentation source
• Added 10 sanitized CORE skill files for public template
• Hook system branding updated from Kai to PAI

---

Full Changelog: v0.6.0...v0.7.0

v0.6.0 - Major Repository Restructure with .claude/ Directory

🔥 v0.6.0 - MAJOR UPGRADE: Repository Restructured with .claude/ Directory

⚠️ BREAKING CHANGE

The repository structure has been completely reorganized. All PAI infrastructure now lives in the .claude/ directory to properly mirror how PAI works in production.

---

🎯 What Changed

Repository Structure (Before → After)

Before (v0.5.0):

/PAI/
├── agents/
├── commands/
├── documentation/
├── hooks/
├── skills/
├── voice-server/
├── settings.json
└── README.md

After (v0.6.0):

/PAI/
├── .claude/                 # ← All PAI infrastructure
│   ├── agents/
│   ├── commands/
│   ├── documentation/
│   ├── hooks/
│   ├── skills/
│   ├── voice-server/
│   ├── settings.json
│   ├── .mcp.json
│   └── setup.sh
├── README.md               # GitHub files stay at root
├── LICENSE
└── .gitignore

---

🚀 Why This Matters

The Problem

Users reported issues with PAI not working correctly because the repository structure didn't match the actual working system. The real PAI system expects all infrastructure to live in ~/.claude/, but the repo had everything at root level, causing:

• Confusion about where files should go
• Compatibility issues during setup
• Difficulty using the repo as a reference

The Solution

1. Proper Emulation: Repository now accurately represents how PAI works in production
2. Easier Setup: Users can see exactly how their ~/.claude/ directory should be structured
3. Less Confusion: Clear separation between GitHub files and PAI infrastructure
4. Better Documentation: Structure itself serves as documentation
5. Reference Implementation: Can be copied/referenced directly for setup

---

📦 Installation (New Users)

# Clone the repository
git clone https://github.com/danielmiessler/Personal_AI_Infrastructure.git
cd Personal_AI_Infrastructure

# Copy .claude directory to your home
cp -r .claude ~/.claude

# Configure environment
cp ~/.claude/.env.example ~/.claude/.env
vim ~/.claude/.env  # Add your API keys

# Set environment variables (add to ~/.zshrc or ~/.bashrc)
export PAI_DIR="$HOME/PAI"  # Points to repo root (for development)
export PAI_HOME="$HOME"

---

🔄 Migration (Existing Users)

No action required for existing installations! Your ~/.claude/ directory is already set up correctly. This change only affects the repository structure, not your working installation.

If you want to update your installation:

cd $PAI_DIR  # Your PAI repo
git pull
# Your existing ~/.claude/ continues to work as-is

---

📋 What's Included

Files Moved to .claude/

• ✅ 8 agent definitions (agents/)
• ✅ 7 command files (commands/)
• ✅ 13 documentation files (documentation/)
• ✅ 11 hook scripts (hooks/)
• ✅ Full skills system including Fabric repo (skills/)
• ✅ Complete voice server (voice-server/)
• ✅ Configuration files (settings.json, .mcp.json, .env.example)
• ✅ Setup and utility scripts

Files Kept at Root (GitHub Infrastructure)

• ✅ README.md
• ✅ LICENSE
• ✅ SECURITY.md
• ✅ .gitignore
• ✅ .github/

---

📚 Documentation Updates

All documentation has been updated to reflect the new structure:

• ✅ README.md - Prominent MAJOR UPGRADE notice
• ✅ architecture.md - v0.6.0 structure notice
• ✅ how-to-start.md - Installation instructions updated
• ✅ QUICK-REFERENCE.md - Path references updated
• ✅ All path examples changed from ${PAI_DIR}/* to ~/.claude/*

---

🔗 Related Issues

This release addresses user-reported compatibility issues and confusion about repository structure. The .claude/ organization makes PAI a proper reference implementation.

---

🙏 Thank You

Thank you to everyone who reported issues and provided feedback about the repository structure. This change makes PAI more accessible and easier to understand for new users.

---

Full Changelog: v0.5.0...v0.6.0

v0.4.0 - Repository Restructure 🔥 BREAKING CHANGE

🔥 BREAKING CHANGE: Repository Restructure

PAI has been restructured for better GitHub UX and renamed for clarity!

⚠️ BREAKING CHANGES

1. PAI_DIR Environment Variable:

# OLD (v0.3.x and earlier):
export PAI_DIR="/path/to/PAI/PAI_DIRECTORY"

# NEW (v0.4.0+):
export PAI_DIR="/path/to/PAI"

2. Repository Renamed:

• Old: danielmiessler/PAI
• New: danielmiessler/Personal_AI_Infrastructure
• GitHub automatically redirects old URL to new URL
• All existing links continue to work

🏗️ What Changed

Flattened Repository Structure:

Before (v0.3.x):           After (v0.4.0):
PAI/                       PAI/
├── PAI_DIRECTORY/         ├── agents/
│   ├── agents/            ├── commands/
│   ├── commands/          ├── documentation/
│   ├── skills/            ├── hooks/
│   └── ...                ├── skills/
├── README.md              ├── voice-server/
└── ...                    ├── .env.example
                           ├── .mcp.json
                           ├── settings.json
                           ├── README.md
                           └── ...

Repository Renamed:

• Repository renamed from PAI to Personal_AI_Infrastructure
• Clearer, more descriptive name
• Better SEO and discoverability
• GitHub automatically redirects old URL

Benefits:

• ✅ Functional directories immediately visible on GitHub
• ✅ No extra click required to see actual content
• ✅ More conventional repository structure
• ✅ Cleaner navigation for new users
• ✅ Better first impression for newcomers

📦 Migration Steps

1. Update PAI_DIR in shell config:

# Edit ~/.zshrc or ~/.bashrc
export PAI_DIR="/path/to/PAI"  # Remove /PAI_DIRECTORY

2. Reload your shell:

source ~/.zshrc  # or source ~/.bashrc

3. Pull latest changes:

cd /path/to/PAI
git pull

4. Update git remote URL (optional but recommended):

git remote set-url origin git@github.com:danielmiessler/Personal_AI_Infrastructure.git
# Or for HTTPS:
git remote set-url origin https://github.com/danielmiessler/Personal_AI_Infrastructure.git

📖 Documentation Updates

• Added prominent v0.4.0 breaking change notice to README
• Updated installation instructions
• Updated all path references throughout documentation
• Updated environment variables section
• Added comprehensive migration guide
• Made core mission statement prominent and centered

🎯 Why This Change

The previous nested structure (PAI_DIRECTORY/) added an unnecessary layer that made the repository less intuitive on GitHub. Users had to click into PAI_DIRECTORY/ to see the actual functional directories.

This restructure brings PAI in line with conventional repository layouts where functional code is immediately visible at the root.

📊 Statistics

• 810+ files moved to root
• Complete Fabric repository (242 patterns) structure preserved
• All git history maintained (100% renames)
• Zero content changes - pure structural refactor

🔗 Links

• Repository: https://github.com/danielmiessler/Personal_AI_Infrastructure
• Documentation: https://github.com/danielmiessler/Personal_AI_Infrastructure/tree/main/documentation
• Issues: https://github.com/danielmiessler/Personal_AI_Infrastructure/issues

---

Full Changelog: v0.3.2...v0.4.0

v0.2.4 - README Cleanup & Organization

🧹 README Cleanup & Organization

This minor release focuses on improving the README organization and reducing visual clutter.

✨ What's New

• 📂 Collapsed Updates Section: Implemented two-level collapsing structure using nested <details> tags (#27)
• 🎯 Better Navigation: Significantly reduced vertical space taken by updates section
• 📊 Space Optimization: Updates now cleanly collapsed while maintaining full accessibility
• 🧹 Issue Management: Closed PR #24 after recent voice system updates
• ✅ Improved UX: All information remains accessible through intuitive collapse/expand interface

🔧 Changes

• Added parent <details> wrapper around all update entries
• Each update entry maintains its own collapsible state
• Most recent update (October 2, 2025) open by default
• Cleaner README with less scrolling required

📦 Installation

See the Quick Start Guide for installation instructions.

---

Full Changelog: v0.2.3...v0.2.4

v0.2.3 - Complete Visibility & Portability Update

🎯 Release v0.2.3 - Complete Visibility & Portability Update

🚀 Overview

This release completes the transformation of PAI into a fully portable, vendor-agnostic, and visible personal AI infrastructure system. No more hidden files, no more hardcoded paths, and full compatibility with all file management tools.

✨ Key Improvements

📁 Complete Visibility

• No More Hidden Files: All configuration files are now visible
  • .claude → PAI_DIRECTORY
  • .zshrc → zshrc-aliases
  • .env-example → env-example
• Tool Compatibility: Works perfectly with Obsidian, file managers, and all tools

🌍 True Vendor Independence

• Not Just for Claude: PAI works with any AI platform
• Supports: Claude, GPT-4, Gemini, and any future AI systems
• Flexible Architecture: Adapt PAI to your preferred AI vendor

🔧 Full Portability

• Dynamic Paths: All hardcoded paths replaced with ${PAI_DIR}
• Install Anywhere: Put PAI wherever you want on your system
• Consistent Configuration: .env lives in ${PAI_DIR}/.env
• No Broken Links: Removed all problematic symbolic links

🐛 Issues Fixed

• ✅ #21: Fixed hardcoded path in session-start-hook.ts
• ✅ #20: Resolved .env file location confusion
• ✅ Removed broken symbolic links
• ✅ Updated all documentation for consistency

📖 Documentation Updates

• All references updated to use ${PAI_DIR}
• Clear installation instructions with new paths
• Emphasized vendor-agnostic design throughout
• Consistent configuration file locations

🔄 Migration Notes

If upgrading from v0.2.2 or earlier:

1. Rename your .claude directory to PAI_DIRECTORY
2. Update your PAI_DIR environment variable
3. Move any .env from home directory to ${PAI_DIR}/.env
4. Configuration files no longer have dot prefixes

🙏 Acknowledgments

Thanks to @saisat and @frederikb96 for issue reports and the community for feedback!

---

Full Changelog: v0.2.2...v0.2.3

v0.2.2 - Directory Visibility & Portability Update

🎯 Release v0.2.2 - Directory Visibility & Portability Update

🚀 What's New

This release focuses on improving file visibility and system portability by removing hidden file prefixes and ensuring all paths are dynamic.

📋 Changes

📁 Directory Structure Improvements

• Renamed .claude to PAI_DIRECTORY for better visibility
• PAI is now truly vendor-agnostic (works with Claude, GPT, Gemini, etc.)
• Better compatibility with tools like Obsidian that have issues with dot-prefixed directories

🔧 Path Portability

• Fixed hardcoded paths in session-start-hook.ts (Fixes #21)
• All paths now use ${PAI_DIR} environment variable
• System is fully portable across different installation locations

📄 Configuration Updates

• .env location standardized to ${PAI_DIR}/.env (Fixes #20)
• All documentation updated to use consistent path
• Central configuration location within PAI installation

👁️ File Visibility

• Renamed .zshrc to zshrc-aliases (no dot prefix)
• Renamed .env-example to env-example (no dot prefix)
• Removed broken symbolic links
• All configuration files now visible in file managers

🐛 Bug Fixes

• Fixed session-start-hook.ts hardcoded path issue (#21)
• Resolved .env file location confusion (#20)
• Removed broken symbolic links

📖 Documentation

• Updated all documentation to reflect new directory structure
• Clarified PAI's vendor-agnostic architecture
• Consistent use of ${PAI_DIR} throughout

🙏 Thanks

Thanks to @saisat and @frederikb96 for reporting issues!

---

Full Changelog: v0.2.1...v0.2.2

v0.2.1 - Hooks System Update

🚀 PAI v0.2.1 - Hooks System Update

What's Changed

🪝 Hooks System Overhaul

• Sanitized for Public Use: All hook files cleaned of sensitive data
• Portable Installation: All hooks now use ${PAI_DIR} variable
• Voice Integration: Enhanced intelligent voice responses
• Tab Title System: Improved terminal tab title generation
• Session Management: Better initialization and state tracking

📁 Files Updated

• session-start-hook.ts - Session initialization with voice notifications
• stop-hook.ts - Terminal tab titles and completion announcements
• user-prompt-submit-hook.ts - Voice greeting system
• subagent-stop-hook.ts - Agent-specific voice notifications
• load-dynamic-requirements.ts - Dynamic context loading wrapper
• hooks/README.md - Hook system documentation

📚 Documentation

• Fixed date formatting issues in main README
• Removed redundant configuration warnings
• Updated September 26, 2025 release notes

Installation Note

Remember to set the PAI_DIR environment variable to your PAI installation's .claude directory for the hooks to work correctly.

Full Changelog: v0.2...v0.2.1

PAI v0.2: Enhanced Documentation & Human 3.0 Integration

🚀 What's New in v0.2

✨ Features

• Human 3.0 Integration: Added direct link to projects fit together blog post
• Enhanced Documentation: Improved README structure and navigation
• Better Badge Styling: Fixed purple color consistency across badges

🐛 Bug Fixes

• Fixed purple color issues in badges (now using proper hex #8B5CF6)
• Fixed stats display badge configuration
• Improved table formatting in architecture section
• Minor display improvements throughout documentation

📚 Documentation

• Added comprehensive v0.2 changelog to Recent Updates section
• Enhanced readability and structure
• Better navigation and information hierarchy

📦 Installation

# Clone the repository
git clone https://github.com/danielmiessler/PAI.git
cd PAI

# Follow setup instructions in README
export PAI_HOME="$HOME"

Full Changelog: v0.1...v0.2

PAI v0.1 - Initial Release

🎉 PAI v0.1 - Initial Release

Open-Source Personal AI Infrastructure for Everyone

This is the first official release of PAI (Personal AI Infrastructure), an open-source platform designed to democratize AI access and give everyone on Earth the power to augment their personal and professional lives with AI.

✨ Key Features

• 🏗️ UFC Context System - Persistent memory architecture with hierarchical organization
• ⚡ 60+ Custom Commands - Ready-to-use commands for work and life management
• 🤖 5 Specialized AI Agents - Researcher, Engineer, Designer, Pentester, Architect
• 🔌 MCP Server Ecosystem - Integrations with Playwright, Stripe, Analytics, and more
• 🪝 Dynamic Hook System - Smart context loading and routing based on intent
• 🎙️ Voice Server - ElevenLabs integration for natural voice interaction
• 📁 Plain Text Configuration - Complete portability and transparency
• 🤖 Platform Independent - Works with Claude, GPT, Gemini, or any AI platform

🚀 Getting Started

1. Clone the repository
2. Install Bun runtime
3. Set PAI_HOME environment variable
4. Configure API keys in .env
5. Start using your personal AI infrastructure!

📚 Documentation

Full documentation available at:

• Quick Start Guide
• Architecture Overview
• UFC Context System
• Agent Documentation
• Voice Server Setup

🎯 Mission

PAI embodies the belief that AI should augment human capability, not replace it. This release represents the first step toward Human 3.0 - where every person has access to powerful AI tools that enhance their unique abilities and help them thrive in an AI-powered world.

🙏 Acknowledgments

Thanks to the early contributors and testers who helped shape this initial release. Special thanks to the Claude Code team at Anthropic for making this development possible.

---

Created by Daniel Miessler

🌐 Blog • 📧 Newsletter • 🎬 YouTube