ai-mac-studio Migration
Complete migration plan and history for the ai-mac-studio reorganization
This page archives the complete migration plan from the disparate ~/ai-* directories to the unified ~/ai-mac-studio/ umbrella.
Migration status
| Phase | Description | Status |
|---|---|---|
| 1 | Platform skeleton, data-mounts.yaml, env.py | ✓ Complete |
| 2 | Registry + catalog.duckdb + MCP orchestra | ✓ Complete |
| 3 | FastAPI reverse proxy on :5001 | ✓ Complete |
| 4 | Central web hub on :5050 | ✓ Complete |
| 5 | apps/ai-applevoicerecorder, scholarly, arxiv | ✓ Complete |
| 6 | Syncthing topology + .stignore templates | ✓ Complete |
| 7 | Quarto sandstone+oxford-blue theme | ✓ Complete |
| 8 | Cursor config rewire (mcp.json, skills, rules) | In progress |
| 9 | ae-platform doctor + archive legacy dirs | Pending |
Key decisions
- No symlinks: all code is real files; bulk data on PDAI-1 via
data_path() - External data:
platform/config/data-mounts.yamlmaps logical names to PDAI-1 paths - Single web hub: Hub on :5050 serves docs + admin UI + API; proxy on :5001 is routing-only
- MCP orchestra: single
ai-platform-mcpentry in~/.cursor/mcp.json - apps/ category: hybrid native+Python workspaces (Xcode + Swift + Python AI)
Running ae-platform migrate
# Preview planned changes (no modifications)
ae-platform migrate
# Execute
ae-platform migrate --commit