Development Scripts

This directory contains scripts to help with development environment setup and Augment thread initialization.

Scripts

ensure-native-shell.js

Purpose: Prevent accidental WSL usage in local Windows development Usage: pnpm env:guard or pnpm env:guard:bash

• Fails when the current process is running inside WSL.
• Fails when the repo path is under a WSL drive mount such as /mnt/c/....
• On Windows, warns when bare bash resolves to C:\Windows\System32\bash.exe.
• With pnpm env:guard:bash, fails when native Git Bash is required but bare bash resolves to WSL.
• Reports the native Git for Windows Bash path when it can find one.
• Runs before install, dev, lint, typecheck, test, rclone bootstrap/check, and Augment startup scripts.

dev-startup.js

Purpose: Automatically check and start development services Usage: pnpm dev:check or pnpm dev:full

• Checks if Next.js app is running on port 3000.
• Checks if rclone service is running on port 3001.
• On Windows, verifies that fly-rclone/rclone.exe exists and matches the pinned Dockerfile version before trying to start the rclone service.
• Automatically starts any missing services.
• Runs services in detached mode (background).

start-local-dev.ps1

Purpose: Open the local development stack in four PowerShell terminals Usage: .\scripts\start-local-dev.ps1 or pnpm dev:terminals