Skip to content

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

Choose a tag to compare

View all tags
@danielmiessler danielmiessler released this 21 Oct 19:09
· 400 commits to main since this release
v0.6.0
6dab135

🔥 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

Assets 2
Loading