Update PAI path resolution to follow XDG base directory standard and decouple from legacy defaults

Author: fpr1m3

AGENTS.md

@@ -20,7 +20,7 @@ The agent's behavior is controlled via environment variables:
 
 | Variable | Description | Default |
 | :--- | :--- | :--- |
-| `PAI_DIR` | Root directory for PAI skills and history | `~/.claude` |
+| `PAI_DIR` | Root directory for PAI skills and history | `$XDG_CONFIG_HOME/opencode` |
 | `DA` | Name of your Digital Assistant | `PAI` |
 | `ENGINEER_NAME` | Your name/identity | `Engineer` |
 | `DA_COLOR` | UI color theme for your DA | `blue` |

README.md

@@ -28,7 +28,7 @@ The plugin centers around the `PAI_DIR` environment variable.
 
 | Variable | Description | Default |
 | :--- | :--- | :--- |
-| `PAI_DIR` | Root directory for PAI skills and history | `~/.claude` |
+| `PAI_DIR` | Root directory for PAI skills and history | `$XDG_CONFIG_HOME/opencode` |
 | `DA` | Name of your Digital Assistant | `PAI` |
 | `ENGINEER_NAME` | Your name/identity | `Engineer` |
 | `DA_COLOR` | UI color theme for your DA | `blue` |

setup.sh

@@ -6,31 +6,35 @@ set -e
 
 # --- Configuration ---
 PLUGIN_PACKAGE="${PLUGIN_PACKAGE_OVERRIDE:-github:fpr1m3/opencode-pai-plugin}"
-PAI_DIR_DEFAULT="$HOME/.claude"
+CONFIG_BASE="${XDG_CONFIG_HOME:-$HOME/.config}"
+PAI_DIR_DEFAULT="$CONFIG_BASE/opencode"
 
 # --- UI Helpers ---
 info() { echo -e "\033[0;34m[PAI INFO]\033[0m $1"; }
 success() { echo -e "\033[0;32m[PAI SUCCESS]\033[0m $1"; }
 warn() { echo -e "\033[0;33m[PAI WARN]\033[0m $1"; }
-error() { echo -e "\033[0;31m[PAI ERROR]\033[0m $1"; exit 1; }
+error() {
+  echo -e "\033[0;31m[PAI ERROR]\033[0m $1"
+  exit 1
+}
 
 # --- Logic ---
 
 info "Starting PAI Plugin installation..."
 
 # 1. Project Detection
 if [ ! -f "package.json" ]; then
-    error "No package.json found. Please run this script from the root of your OpenCode project."
+  error "No package.json found. Please run this script from the root of your OpenCode project."
 fi
 
 # 2. Dependency Installation
 info "Installing plugin package..."
 if command -v bun >/dev/null 2>&1; then
-    bun add "$PLUGIN_PACKAGE"
+  bun add "$PLUGIN_PACKAGE"
 elif command -v npm >/dev/null 2>&1; then
-    npm install "$PLUGIN_PACKAGE"
+  npm install "$PLUGIN_PACKAGE"
 else
-    error "Neither bun nor npm found. Please install a package manager."
+  error "Neither bun nor npm found. Please install a package manager."
 fi
 
 # 3. Plugin Registration
@@ -39,14 +43,14 @@ mkdir -p .opencode/plugins
 
 PLUGIN_REG_FILE=".opencode/plugins/pai.ts"
 if [ -f "$PLUGIN_REG_FILE" ]; then
-    warn "$PLUGIN_REG_FILE already exists. Skipping registration."
+  warn "$PLUGIN_REG_FILE already exists. Skipping registration."
 else
-    cat > "$PLUGIN_REG_FILE" <<EOF
+  cat >"$PLUGIN_REG_FILE" <<EOF
 import { PAIPlugin } from "opencode-pai-plugin";
 
 export default PAIPlugin;
 EOF
-    success "Plugin registered in $PLUGIN_REG_FILE"
+  success "Plugin registered in $PLUGIN_REG_FILE"
 fi
 
 # 4. PAI Infrastructure Check
@@ -55,29 +59,29 @@ CORE_SKILL_FILE="$CURRENT_PAI_DIR/skills/core/SKILL.md"
 info "Checking PAI infrastructure at $CURRENT_PAI_DIR..."
 
 if [ ! -f "$CORE_SKILL_FILE" ]; then
-    warn "PAI core identity not found at $CORE_SKILL_FILE"
-    # Auto-initialize if non-interactive or if user says yes
-    if [[ "$CI" == "true" ]] || [[ "$PAI_NON_INTERACTIVE" == "true" ]]; then
-        INITIALIZE_PAI="y"
-    else
-        read -p "Would you like to initialize a basic PAI structure now? (y/n) " -n 1 -r
-        echo ""
-        INITIALIZE_PAI=$REPLY
-    fi
+  warn "PAI core identity not found at $CORE_SKILL_FILE"
+  # Auto-initialize if non-interactive or if user says yes
+  if [[ "$CI" == "true" ]] || [[ "$PAI_NON_INTERACTIVE" == "true" ]]; then
+    INITIALIZE_PAI="y"
+  else
+    read -p "Would you like to initialize a basic PAI structure now? (y/n) " -n 1 -r
+    echo ""
+    INITIALIZE_PAI=$REPLY
+  fi
 
-    if [[ $INITIALIZE_PAI =~ ^[Yy]$ ]]; then
-        mkdir -p "$CURRENT_PAI_DIR/skills/core"
-        mkdir -p "$CURRENT_PAI_DIR/history/raw-outputs"
-        mkdir -p "$CURRENT_PAI_DIR/history/sessions"
-        
-        cat > "$CORE_SKILL_FILE" <<EOF
+  if [[ $INITIALIZE_PAI =~ ^[Yy]$ ]]; then
+    mkdir -p "$CURRENT_PAI_DIR/skills/core"
+    mkdir -p "$CURRENT_PAI_DIR/history/raw-outputs"
+    mkdir -p "$CURRENT_PAI_DIR/history/sessions"
+
+    cat >"$CORE_SKILL_FILE" <<EOF
 # PAI Core Identity
 You are {{DA}}, a Personal AI Infrastructure. 
 Your primary engineer is {{ENGINEER_NAME}}.
 EOF
-        info "Created default SKILL.md"
-        success "PAI structure initialized."
-    fi
+    info "Created default SKILL.md"
+    success "PAI structure initialized."
+  fi
 fi
 
 success "PAI Plugin installation complete!"

src/lib/paths.ts

@@ -16,11 +16,13 @@ import { existsSync } from 'fs';
  * Smart PAI_DIR detection with fallback
  * Priority:
  * 1. PAI_DIR environment variable (if set)
- * 2. ~/.claude (standard location)
+ * 2. $XDG_CONFIG_HOME/opencode (standard XDG location)
+ * 3. ~/.config/opencode (fallback if XDG_CONFIG_HOME is not set)
  */
+const XDG_CONFIG_HOME = process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
 export const PAI_DIR = process.env.PAI_DIR
   ? resolve(process.env.PAI_DIR)
-  : resolve(homedir(), '.claude');
+  : resolve(XDG_CONFIG_HOME, 'opencode');
 
 /**
  * Common PAI directories