multimodel-dev-os 0.3.0

package/scripts/install.ps1

@@ -0,0 +1,230 @@
+# multimodel-dev-os installer for Windows (PowerShell)
+# Usage: irm https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.ps1 | iex
+# Flags: -Caveman  (use minimal-token templates)
+#        -All      (install all adapters)
+#        -DryRun   (show what would be created without creating)
+
+param(
+  [switch]$Caveman,
+  [switch]$All,
+  [switch]$DryRun,
+  [switch]$Help
+)
+
+$Version = "0.1.0"
+$RepoUrl = "https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main"
+
+if ($Help) {
+  Write-Host "multimodel-dev-os installer v$Version" -ForegroundColor Blue
+  Write-Host ""
+  Write-Host "Usage: irm .../install.ps1 | iex"
+  Write-Host ""
+  Write-Host "Options:"
+  Write-Host "  -Caveman   Use minimal-token templates (~79% fewer tokens)"
+  Write-Host "  -All       Install all adapters"
+  Write-Host "  -DryRun    Show what would be created without creating"
+  Write-Host "  -Help      Show this help message"
+  return
+}
+
+Write-Host "multimodel-dev-os installer v$Version" -ForegroundColor Blue
+Write-Host ""
+
+# --- Helper Functions ---
+
+function New-ProjectFile {
+  param(
+    [string]$Path,
+    [string]$Url
+  )
+
+  if (Test-Path $Path) {
+    Write-Host "  SKIP $Path (already exists)" -ForegroundColor Yellow
+    return
+  }
+
+  if ($DryRun) {
+    Write-Host "  WOULD CREATE $Path" -ForegroundColor Blue
+    return
+  }
+
+  $dir = Split-Path -Parent $Path
+  if ($dir -and !(Test-Path $dir)) {
+    New-Item -ItemType Directory -Path $dir -Force | Out-Null
+  }
+
+  try {
+    Invoke-WebRequest -Uri $Url -OutFile $Path -UseBasicParsing -ErrorAction Stop
+    Write-Host "  CREATE $Path" -ForegroundColor Green
+  }
+  catch {
+    Write-Host "  FAIL $Path (download failed)" -ForegroundColor Red
+  }
+}
+
+function New-ProjectDir {
+  param([string]$Path)
+
+  if (Test-Path $Path) {
+    Write-Host "  SKIP $Path/ (already exists)" -ForegroundColor Yellow
+    return
+  }
+
+  if ($DryRun) {
+    Write-Host "  WOULD CREATE $Path/" -ForegroundColor Blue
+    return
+  }
+
+  New-Item -ItemType Directory -Path $Path -Force | Out-Null
+  Write-Host "  CREATE $Path/" -ForegroundColor Green
+}
+
+# --- Phase 1: Core Files ---
+
+Write-Host "Creating core files..." -ForegroundColor Blue
+
+if ($Caveman) {
+  New-ProjectFile "AGENTS.md" "$RepoUrl/.ai/templates/AGENTS.caveman.md"
+  New-ProjectFile "MEMORY.md" "$RepoUrl/.ai/templates/MEMORY.caveman.md"
+  New-ProjectFile "TASKS.md" "$RepoUrl/.ai/templates/TASKS.caveman.md"
+  New-ProjectFile "RUNBOOK.md" "$RepoUrl/.ai/templates/RUNBOOK.caveman.md"
+}
+else {
+  New-ProjectFile "AGENTS.md" "$RepoUrl/AGENTS.md"
+  New-ProjectFile "MEMORY.md" "$RepoUrl/MEMORY.md"
+  New-ProjectFile "TASKS.md" "$RepoUrl/TASKS.md"
+  New-ProjectFile "RUNBOOK.md" "$RepoUrl/RUNBOOK.md"
+}
+New-ProjectFile ".gitattributes" "$RepoUrl/.gitattributes"
+New-ProjectFile "bin/multimodel-dev-os.js" "$RepoUrl/bin/multimodel-dev-os.js"
+
+# --- Phase 2: .ai/ Directory ---
+
+Write-Host ""
+Write-Host "Creating .ai/ directory..." -ForegroundColor Blue
+
+New-ProjectFile ".ai/config.yaml" "$RepoUrl/.ai/config.yaml"
+New-ProjectDir ".ai/context"
+New-ProjectFile ".ai/context/README.md" "$RepoUrl/.ai/context/README.md"
+New-ProjectDir ".ai/agents"
+New-ProjectFile ".ai/agents/README.md" "$RepoUrl/.ai/agents/README.md"
+New-ProjectFile ".ai/agents/multimodel-orchestrator.md" "$RepoUrl/.ai/agents/multimodel-orchestrator.md"
+New-ProjectDir ".ai/skills"
+New-ProjectFile ".ai/skills/README.md" "$RepoUrl/.ai/skills/README.md"
+New-ProjectFile ".ai/skills/example-skill.md" "$RepoUrl/.ai/skills/example-skill.md"
+New-ProjectDir ".ai/prompts"
+New-ProjectFile ".ai/prompts/README.md" "$RepoUrl/.ai/prompts/README.md"
+New-ProjectDir ".ai/checks"
+New-ProjectFile ".ai/checks/README.md" "$RepoUrl/.ai/checks/README.md"
+New-ProjectFile ".ai/checks/pre-commit.md" "$RepoUrl/.ai/checks/pre-commit.md"
+New-ProjectDir ".ai/session-logs"
+New-ProjectFile ".ai/session-logs/README.md" "$RepoUrl/.ai/session-logs/README.md"
+New-ProjectDir ".ai/templates"
+New-ProjectFile ".ai/templates/AGENTS.caveman.md" "$RepoUrl/.ai/templates/AGENTS.caveman.md"
+New-ProjectFile ".ai/templates/MEMORY.caveman.md" "$RepoUrl/.ai/templates/MEMORY.caveman.md"
+New-ProjectFile ".ai/templates/TASKS.caveman.md" "$RepoUrl/.ai/templates/TASKS.caveman.md"
+New-ProjectFile ".ai/templates/RUNBOOK.caveman.md" "$RepoUrl/.ai/templates/RUNBOOK.caveman.md"
+
+# --- Phase 3: Adapters ---
+
+Write-Host ""
+
+function Install-Adapter {
+  param([string]$Name)
+
+  Write-Host "Installing $Name adapter..." -ForegroundColor Blue
+
+  switch ($Name) {
+    "codex" {
+      New-ProjectFile "adapters/codex/AGENTS.md" "$RepoUrl/adapters/codex/AGENTS.md"
+      New-ProjectFile "adapters/codex/setup.md" "$RepoUrl/adapters/codex/setup.md"
+    }
+    "antigravity" {
+      New-ProjectFile "adapters/antigravity/AGENTS.md" "$RepoUrl/adapters/antigravity/AGENTS.md"
+      New-ProjectFile "adapters/antigravity/.gemini/settings.json" "$RepoUrl/adapters/antigravity/.gemini/settings.json"
+      New-ProjectFile "adapters/antigravity/setup.md" "$RepoUrl/adapters/antigravity/setup.md"
+    }
+    "cursor" {
+      New-ProjectFile "adapters/cursor/.cursorrules" "$RepoUrl/adapters/cursor/.cursorrules"
+      New-ProjectFile "adapters/cursor/setup.md" "$RepoUrl/adapters/cursor/setup.md"
+    }
+    "claude" {
+      New-ProjectFile "adapters/claude/CLAUDE.md" "$RepoUrl/adapters/claude/CLAUDE.md"
+      New-ProjectFile "adapters/claude/setup.md" "$RepoUrl/adapters/claude/setup.md"
+    }
+    "gemini" {
+      New-ProjectFile "adapters/gemini/GEMINI.md" "$RepoUrl/adapters/gemini/GEMINI.md"
+      New-ProjectFile "adapters/gemini/setup.md" "$RepoUrl/adapters/gemini/setup.md"
+    }
+    "vscode" {
+      New-ProjectFile "adapters/vscode/.vscode/settings.json" "$RepoUrl/adapters/vscode/.vscode/settings.json"
+      New-ProjectFile "adapters/vscode/setup.md" "$RepoUrl/adapters/vscode/setup.md"
+    }
+  }
+}
+
+if ($All) {
+  foreach ($adapter in @("codex", "antigravity", "cursor", "claude", "gemini", "vscode")) {
+    Install-Adapter $adapter
+  }
+}
+else {
+  Write-Host "Which adapters do you want to install?" -ForegroundColor Yellow
+  Write-Host "  1) all"
+  Write-Host "  2) codex"
+  Write-Host "  3) antigravity"
+  Write-Host "  4) cursor"
+  Write-Host "  5) claude"
+  Write-Host "  6) gemini"
+  Write-Host "  7) vscode"
+  Write-Host "  8) none"
+  Write-Host ""
+  $choices = Read-Host "Enter choices (comma-separated, e.g., 2,4,5)"
+
+  if ([string]::IsNullOrWhiteSpace($choices) -or $choices -eq "8") {
+    Write-Host "Skipping adapters." -ForegroundColor Yellow
+  }
+  elseif ($choices -eq "1") {
+    foreach ($adapter in @("codex", "antigravity", "cursor", "claude", "gemini", "vscode")) {
+      Install-Adapter $adapter
+    }
+  }
+  else {
+    $selected = $choices -split "," | ForEach-Object { $_.Trim() }
+    foreach ($choice in $selected) {
+      switch ($choice) {
+        "2" { Install-Adapter "codex" }
+        "3" { Install-Adapter "antigravity" }
+        "4" { Install-Adapter "cursor" }
+        "5" { Install-Adapter "claude" }
+        "6" { Install-Adapter "gemini" }
+        "7" { Install-Adapter "vscode" }
+        default { Write-Host "Unknown choice: $choice" -ForegroundColor Red }
+      }
+    }
+  }
+}
+
+# --- Summary ---
+
+Write-Host ""
+Write-Host "multimodel-dev-os installed!" -ForegroundColor Green
+Write-Host ""
+Write-Host "Next steps:"
+Write-Host "  1. Edit AGENTS.md with your project details"
+Write-Host "  2. Edit .ai/config.yaml to enable your adapters"
+Write-Host "  3. Copy adapter files to your project root as needed:"
+Write-Host "     - Cursor: Copy-Item adapters/cursor/.cursorrules .cursorrules"
+Write-Host "     - Claude: Copy-Item adapters/claude/CLAUDE.md CLAUDE.md"
+Write-Host "     - VS Code: Copy-Item -Recurse adapters/vscode/.vscode/ .vscode/"
+Write-Host ""
+Write-Host "  Docs: https://github.com/rizvee/multimodel-dev-os"
+Write-Host ""
+
+if ($Caveman) {
+  Write-Host "  Caveman Mode active - minimal-token templates installed" -ForegroundColor Yellow
+}
+
+if ($DryRun) {
+  Write-Host "  Dry run - no files were created" -ForegroundColor Blue
+}

package/scripts/install.sh

@@ -0,0 +1,237 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# multimodel-dev-os installer for macOS / Linux / WSL
+# Usage: curl -fsSL https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main/scripts/install.sh | bash
+# Flags: --caveman  (use minimal-token templates)
+#        --all      (install all adapters)
+#        --dry-run  (show what would be created without creating)
+
+VERSION="0.1.0"
+REPO_URL="https://raw.githubusercontent.com/rizvee/multimodel-dev-os/main"
+CAVEMAN=false
+DRY_RUN=false
+INSTALL_ALL=false
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Parse arguments
+for arg in "$@"; do
+  case $arg in
+    --caveman) CAVEMAN=true ;;
+    --dry-run) DRY_RUN=true ;;
+    --all) INSTALL_ALL=true ;;
+    --help)
+      echo "multimodel-dev-os installer v${VERSION}"
+      echo ""
+      echo "Usage: curl -fsSL .../install.sh | bash [-s -- OPTIONS]"
+      echo ""
+      echo "Options:"
+      echo "  --caveman   Use minimal-token templates (~79% fewer tokens)"
+      echo "  --all       Install all adapters"
+      echo "  --dry-run   Show what would be created without creating"
+      echo "  --help      Show this help message"
+      exit 0
+      ;;
+    *)
+      echo -e "${RED}Unknown option: $arg${NC}"
+      exit 1
+      ;;
+  esac
+done
+
+echo -e "${BLUE}multimodel-dev-os installer v${VERSION}${NC}"
+echo ""
+
+# --- Helper Functions ---
+
+create_file() {
+  local path="$1"
+  local url="$2"
+
+  if [ -f "$path" ]; then
+    echo -e "  ${YELLOW}SKIP${NC} $path (already exists)"
+    return
+  fi
+
+  if [ "$DRY_RUN" = true ]; then
+    echo -e "  ${BLUE}WOULD CREATE${NC} $path"
+    return
+  fi
+
+  mkdir -p "$(dirname "$path")"
+  if curl -fsSL "$url" -o "$path" 2>/dev/null; then
+    echo -e "  ${GREEN}CREATE${NC} $path"
+  else
+    echo -e "  ${RED}FAIL${NC} $path (download failed)"
+  fi
+}
+
+create_dir() {
+  local path="$1"
+
+  if [ -d "$path" ]; then
+    echo -e "  ${YELLOW}SKIP${NC} $path/ (already exists)"
+    return
+  fi
+
+  if [ "$DRY_RUN" = true ]; then
+    echo -e "  ${BLUE}WOULD CREATE${NC} $path/"
+    return
+  fi
+
+  mkdir -p "$path"
+  echo -e "  ${GREEN}CREATE${NC} $path/"
+}
+
+# --- Phase 1: Core Files ---
+
+echo -e "${BLUE}Creating core files...${NC}"
+
+if [ "$CAVEMAN" = true ]; then
+  create_file "AGENTS.md" "${REPO_URL}/.ai/templates/AGENTS.caveman.md"
+  create_file "MEMORY.md" "${REPO_URL}/.ai/templates/MEMORY.caveman.md"
+  create_file "TASKS.md" "${REPO_URL}/.ai/templates/TASKS.caveman.md"
+  create_file "RUNBOOK.md" "${REPO_URL}/.ai/templates/RUNBOOK.caveman.md"
+else
+  create_file "AGENTS.md" "${REPO_URL}/AGENTS.md"
+  create_file "MEMORY.md" "${REPO_URL}/MEMORY.md"
+  create_file "TASKS.md" "${REPO_URL}/TASKS.md"
+  create_file "RUNBOOK.md" "${REPO_URL}/RUNBOOK.md"
+fi
+create_file ".gitattributes" "${REPO_URL}/.gitattributes"
+create_file "bin/multimodel-dev-os.js" "${REPO_URL}/bin/multimodel-dev-os.js"
+
+# --- Phase 2: .ai/ Directory ---
+
+echo ""
+echo -e "${BLUE}Creating .ai/ directory...${NC}"
+
+create_file ".ai/config.yaml" "${REPO_URL}/.ai/config.yaml"
+create_dir ".ai/context"
+create_file ".ai/context/README.md" "${REPO_URL}/.ai/context/README.md"
+create_dir ".ai/agents"
+create_file ".ai/agents/README.md" "${REPO_URL}/.ai/agents/README.md"
+create_file ".ai/agents/multimodel-orchestrator.md" "${REPO_URL}/.ai/agents/multimodel-orchestrator.md"
+create_dir ".ai/skills"
+create_file ".ai/skills/README.md" "${REPO_URL}/.ai/skills/README.md"
+create_file ".ai/skills/example-skill.md" "${REPO_URL}/.ai/skills/example-skill.md"
+create_dir ".ai/prompts"
+create_file ".ai/prompts/README.md" "${REPO_URL}/.ai/prompts/README.md"
+create_dir ".ai/checks"
+create_file ".ai/checks/README.md" "${REPO_URL}/.ai/checks/README.md"
+create_file ".ai/checks/pre-commit.md" "${REPO_URL}/.ai/checks/pre-commit.md"
+create_dir ".ai/session-logs"
+create_file ".ai/session-logs/README.md" "${REPO_URL}/.ai/session-logs/README.md"
+create_dir ".ai/templates"
+create_file ".ai/templates/AGENTS.caveman.md" "${REPO_URL}/.ai/templates/AGENTS.caveman.md"
+create_file ".ai/templates/MEMORY.caveman.md" "${REPO_URL}/.ai/templates/MEMORY.caveman.md"
+create_file ".ai/templates/TASKS.caveman.md" "${REPO_URL}/.ai/templates/TASKS.caveman.md"
+create_file ".ai/templates/RUNBOOK.caveman.md" "${REPO_URL}/.ai/templates/RUNBOOK.caveman.md"
+
+# --- Phase 3: Adapters ---
+
+echo ""
+
+install_adapter() {
+  local name="$1"
+  echo -e "${BLUE}Installing $name adapter...${NC}"
+
+  case $name in
+    codex)
+      create_file "adapters/codex/AGENTS.md" "${REPO_URL}/adapters/codex/AGENTS.md"
+      create_file "adapters/codex/setup.md" "${REPO_URL}/adapters/codex/setup.md"
+      ;;
+    antigravity)
+      create_file "adapters/antigravity/AGENTS.md" "${REPO_URL}/adapters/antigravity/AGENTS.md"
+      create_file "adapters/antigravity/.gemini/settings.json" "${REPO_URL}/adapters/antigravity/.gemini/settings.json"
+      create_file "adapters/antigravity/setup.md" "${REPO_URL}/adapters/antigravity/setup.md"
+      ;;
+    cursor)
+      create_file "adapters/cursor/.cursorrules" "${REPO_URL}/adapters/cursor/.cursorrules"
+      create_file "adapters/cursor/setup.md" "${REPO_URL}/adapters/cursor/setup.md"
+      ;;
+    claude)
+      create_file "adapters/claude/CLAUDE.md" "${REPO_URL}/adapters/claude/CLAUDE.md"
+      create_file "adapters/claude/setup.md" "${REPO_URL}/adapters/claude/setup.md"
+      ;;
+    gemini)
+      create_file "adapters/gemini/GEMINI.md" "${REPO_URL}/adapters/gemini/GEMINI.md"
+      create_file "adapters/gemini/setup.md" "${REPO_URL}/adapters/gemini/setup.md"
+      ;;
+    vscode)
+      create_file "adapters/vscode/.vscode/settings.json" "${REPO_URL}/adapters/vscode/.vscode/settings.json"
+      create_file "adapters/vscode/setup.md" "${REPO_URL}/adapters/vscode/setup.md"
+      ;;
+  esac
+}
+
+if [ "$INSTALL_ALL" = true ]; then
+  for adapter in codex antigravity cursor claude gemini vscode; do
+    install_adapter "$adapter"
+  done
+else
+  echo -e "${YELLOW}Which adapters do you want to install?${NC}"
+  echo "  1) all"
+  echo "  2) codex"
+  echo "  3) antigravity"
+  echo "  4) cursor"
+  echo "  5) claude"
+  echo "  6) gemini"
+  echo "  7) vscode"
+  echo "  8) none"
+  echo ""
+  echo -n "Enter choices (comma-separated, e.g., 2,4,5): "
+  read -r choices
+
+  if [ -z "$choices" ] || [ "$choices" = "8" ]; then
+    echo -e "${YELLOW}Skipping adapters.${NC}"
+  elif [ "$choices" = "1" ]; then
+    for adapter in codex antigravity cursor claude gemini vscode; do
+      install_adapter "$adapter"
+    done
+  else
+    IFS=',' read -ra selected <<< "$choices"
+    for choice in "${selected[@]}"; do
+      choice=$(echo "$choice" | tr -d ' ')
+      case $choice in
+        2) install_adapter "codex" ;;
+        3) install_adapter "antigravity" ;;
+        4) install_adapter "cursor" ;;
+        5) install_adapter "claude" ;;
+        6) install_adapter "gemini" ;;
+        7) install_adapter "vscode" ;;
+        *) echo -e "${RED}Unknown choice: $choice${NC}" ;;
+      esac
+    done
+  fi
+fi
+
+# --- Summary ---
+
+echo ""
+echo -e "${GREEN}✅ multimodel-dev-os installed!${NC}"
+echo ""
+echo "Next steps:"
+echo "  1. Edit AGENTS.md with your project details"
+echo "  2. Edit .ai/config.yaml to enable your adapters"
+echo "  3. Copy adapter files to your project root as needed:"
+echo "     - Cursor: cp adapters/cursor/.cursorrules .cursorrules"
+echo "     - Claude: cp adapters/claude/CLAUDE.md CLAUDE.md"
+echo "     - VS Code: cp -r adapters/vscode/.vscode/ .vscode/"
+echo ""
+echo "  Docs: https://github.com/rizvee/multimodel-dev-os"
+echo ""
+
+if [ "$CAVEMAN" = true ]; then
+  echo -e "  ${YELLOW}🦴 Caveman Mode active — minimal-token templates installed${NC}"
+fi
+
+if [ "$DRY_RUN" = true ]; then
+  echo -e "  ${BLUE}🔍 Dry run — no files were created${NC}"
+fi

package/scripts/pack-template.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Pack multimodel-dev-os template files into a distributable archive.
+# Used for future npm/CLI packaging. Does not include .git, examples, or docs.
+
+VERSION="${1:-0.1.0}"
+OUTPUT="multimodel-dev-os-${VERSION}.tar.gz"
+
+echo "Packing multimodel-dev-os v${VERSION}..."
+
+INCLUDE=(
+  AGENTS.md
+  MEMORY.md
+  TASKS.md
+  RUNBOOK.md
+  .ai/
+  adapters/
+)
+
+# Check that required files exist
+for item in "${INCLUDE[@]}"; do
+  if [ ! -e "$item" ]; then
+    echo "ERROR: $item not found. Run from the repo root."
+    exit 1
+  fi
+done
+
+tar -czf "$OUTPUT" \
+  --exclude='*.gitkeep' \
+  --exclude='.ai/session-logs/*.md' \
+  --exclude='!.ai/session-logs/README.md' \
+  "${INCLUDE[@]}"
+
+echo "Created: $OUTPUT"
+echo "Contents:"
+tar -tzf "$OUTPUT" | head -30
+echo "..."
+echo "Done."