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