PAI v2.3.0 - Full Releases Return

PAI v2.3.0 - Full Releases Return

The most significant release since v2.0. PAI v2.3 brings back complete, functional releases while maintaining the modular Packs system. Now you can install PAI two ways: grab individual packs for specific capabilities, or download a complete .claude/ directory and start immediately.

---

🎯 Highlights

Full Releases Are Back

The Releases/v2.3/.claude/ directory contains a complete, functional PAI installation. Copy it to ~/.claude/ and you're running. No assembly required.

This addresses the most common feedback since v2.0: "I love the modular approach, but I just want the whole thing." Now you have both options.

Euphoric Surprise

PAI v2.3 introduces Euphoric Surprise as the north star—the singular pursuit that drives every interaction. Not just task completion, but results so thorough and thoughtful that you're genuinely surprised and delighted. This philosophy is now embedded throughout the documentation and skill design.

Customization as Principle #1

The PAI Founding Principles have been updated. Customization for Your Goals is now Principle #1—PAI exists to help you accomplish your goals in life. It democratizes access to personalized agentic infrastructure that knows your context, preferences, and history.

---

📦 What's in v2.3

Complete Release (Releases/v2.3/.claude/)

Component	Count	Description
Skills	22	Full skill modules with workflows
Named Agents	11	Agents with personalities (Artist, Architect, Engineer, etc.)
Hooks	15	Lifecycle event handlers
Fabric Patterns	100+	Reusable prompt patterns

Skills Included:

• Core: CORE, System, THEALGORITHM
• Research: Research, OSINT, PrivateInvestigator, AnnualReports
• Creative: Art, Prompting, Council, RedTeam
• Development: Browser, CreateCLI, CreateSkill, Agents
• Infrastructure: PAIUpgrade, BrightData, Telos, FirstPrinciples, Recon

Named Agents:
Artist, QATester, Architect, Designer, GeminiResearcher, GrokResearcher, CodexResearcher, Pentester, Intern, Engineer, ClaudeResearcher

Updated Packs (23 total)

All packs updated to v2.3 standards:

• Standardized INSTALL.md with AI wizard format
• Icon references in all READMEs
• Consistent versioning

---

⚡ Installation

Option 1: Full Installation (Recommended for New Users)

# Download v2.3 release
# Copy .claude/ to your home directory
cp -r Releases/v2.3/.claude ~/.claude

# Run installation wizard
cd ~/.claude && bun run install.ts

# Start using PAI
claude

Option 2: Individual Packs (Existing Users)

Browse Packs/ and install specific capabilities. Each pack is self-contained with complete instructions.

---

🔄 Changes Since v2.1.0

Major

• Full releases restored - Complete .claude/ directory in Releases/v2.3/
• 23 packs updated for v2.3 release
• Euphoric Surprise added as north star
• Customization elevated to Principle #1
• Visual README redesign with technical diagrams

Infrastructure

• Retired pai-history-system, migrated to MEMORY in core
• Security system upgrade to directory-based architecture
• Voice integration improvements in pai-core-install
• All pack INSTALL.md standardized to AI wizard format

Documentation

• Comprehensive README overhaul
• ELI5 section for newcomers ("Wait, Hold On—Assume I'm New to All This")
• Updated typing animation and badges
• Logo updated to v7

---

🚀 Getting Started

1. Watch the walkthrough: PAI Overview Video
2. Read the philosophy: The Real Internet of Things
3. Understand the vision: Personal AI Maturity Model

---

📊 Stats

• 34 commits since v2.1.0
• 22 skills in full release
• 11 named agents with personalities
• 23 packs available
• 100+ fabric patterns included

---

PAI - Magnifying human capabilities through personalized AI infrastructure.

Everyone deserves AI that gets better at helping them over time. This is open-source. This is free. This is for everyone.

PAI v2.1.0 - Major Core Upgrade & New Upgrades Skill

PAI v2.1.0 - Major Core Upgrade & New Upgrades Skill

This release includes significant updates to the core infrastructure and introduces a new skill for tracking system upgrades.

Major Updates

pai-core-install v1.2.0 (Major Upgrade)

The core pack received its biggest update yet:

• NEW: MEMORY/ skeleton - 11-directory structure for session history, learnings, decisions, and state management
• NEW: settings.json.template - Complete hook configuration template with all events pre-configured
• USER/ directory (15 templates) - Personal configuration for identity, contacts, preferences
• SYSTEM/ directory (17 templates) - System architecture documentation for skills, hooks, memory, delegation
• Wizard-style installation - The installer now walks you through setup step-by-step with clear phases

This update transforms pai-core-install from a basic foundation into a complete infrastructure framework.

pai-browser-skill v1.2.0

Enhanced browser automation with debug-first philosophy:

• Always-on diagnostics and console capture
• Session auto-start capability
• 99% token savings through file-based MCP pattern

NEW: pai-upgrades-skill v1.0.0

A new skill for tracking and managing PAI system upgrades:

• Monitors for new features and capabilities
• Tracks upgrade opportunities
• Maintains upgrade history
• Helps plan and prioritize system improvements

Documentation Updates

• Updated pack count badge (8 → 10 packs)
• Fixed bundle references (Kai/ → Official/)
• Updated installation order with new skill
• Refreshed version numbers across all documentation

Install

# Fresh install
cd PAI/Bundles/Official && bun run install.ts

# Upgrade existing installation
cd PAI/Bundles/Official && bun run install.ts --update

What's Next

• More skills coming to the pack ecosystem
• Enhanced wizard-style installation across all packs
• Community contributions welcome!

---

Full Changelog: v2.0.0...v2.1.0

v2.0.0 - PAI Packs System Launch

PAI v2.0.0 - PAI Packs System Launch

Major Architecture Shift

• Transitioned from "mirrored system" approach to modular PAI Packs
• Packs are self-contained, AI-installable capability bundles
• Platform-agnostic design: works with Claude Code, OpenCode, Gemini Code, GPT-Codex, or custom systems

Available Packs (8)

• kai-core-install - Foundation pack with skill routing, identity, and architecture tracking
• kai-hook-system - Event-driven hook architecture
• kai-history-system - Automatic context-tracking
• kai-voice-system - Voice notifications with ElevenLabs TTS
• kai-art-skill - Visual content creation
• kai-prompting-skill - Meta-prompting system
• kai-agents-skill - Dynamic agent composition
• kai-observability-server - Real-time agent monitoring

Available Bundles (1)

• kai-core-bundle - Complete Kai infrastructure (4 foundational packs)

Why the Change?

• v1.x tried to mirror the entire Kai system - too fragile, too many interdependencies
• v2.0 extracts battle-tested features as independent, installable modules
• Each pack is like learning kung-fu in The Matrix - a complete capability download

Documentation

• Full pack template specification
• Complete pack system documentation
• Updated README with 14 Founding Principles and installation guide

v0.9.0 - Platform Agnostic Release

PAI v0.9.0 - Platform Agnostic Release

This release focuses on making PAI fully portable and fork-friendly. Your AI, your identity, your system.

Highlights

Observability Dashboard

• Complete real-time agent monitoring at .claude/Observability/
• WebSocket streaming of all agent activity
• Live pulse charts, event timelines, and swim lanes
• Multiple themes (Tokyo Night, Nord, Catppuccin, etc.)
• Security obfuscation for sensitive data
• Run with: ~/.claude/Observability/manage.sh start

Genericized Agent Identity

• All agent references now use process.env.DA || 'main'
• No more hardcoded names - your DA name flows through the entire system
• Observability dashboard shows your configured identity
• Color system supports any DA name with intelligent defaults

Platform-Agnostic Configuration

• Added _envDocs to settings.json explaining all environment variables
• Clear separation: settings.json for identity/paths, .env for API keys
• DA (Digital Assistant name) - your AI's identity
• PAI_DIR - root directory for all configuration
• TIME_ZONE - configurable timezone for timestamps

Statusline Enhancements

• Terminal color compatibility mode for different terminal emulators
• Dynamic Claude Code version display
• Cleaner greeting format

Skill System Improvements

• Canonical TitleCase file naming throughout
• Standardized skill-workflow-notification script for dashboard detection
• All paths use ${PAI_DIR}/ for location-agnostic installation

Breaking Changes

None - this release is backwards compatible.

Upgrade Instructions

cd ~/.claude  # or your PAI_DIR
git pull origin main

If using a fresh install, follow the Quick Start in README.md.

---

Full Changelog: v0.7.0...v0.9.0

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