Skip to content

v0.4.0 - Repository Restructure πŸ”₯ BREAKING CHANGE

Choose a tag to compare

@danielmiessler danielmiessler released this 17 Oct 23:03
· 604 commits to main since this release

πŸ”₯ 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


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