From 71a57586bdf65bbaff55f364024cd2c3221598a5 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:27:18 +0000 Subject: [PATCH 1/3] Initial plan From 75c8437a4d7f54958917fa76887e8ef983ab3a3b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:29:08 +0000 Subject: [PATCH 2/3] Add project identification header to Spanish installation guide (INSTALL_ES.md) Co-authored-by: luisespersonal-byte <249453885+luisespersonal-byte@users.noreply.github.com> --- INSTALL_ES.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/INSTALL_ES.md b/INSTALL_ES.md index 22d62425..f2e757b0 100644 --- a/INSTALL_ES.md +++ b/INSTALL_ES.md @@ -1,4 +1,10 @@ -# Guía de Instalación en macOS +# Copilot for Xcode Logo + +**Copilot for Xcode** es el proyecto de GitHub que permite usar **GitHub Copilot como agente dentro de Xcode**. Es una extensión del editor de código fuente de Xcode que integra GitHub Copilot, Codeium y ChatGPT directamente en tu entorno de desarrollo. + +- 🔗 Proyecto en GitHub: [https://github.com/intitni/CopilotForXcode](https://github.com/intitni/CopilotForXcode) + +## Guía de Instalación en macOS [English installation instructions / Instrucciones de instalación en inglés](README.md#installation-and-setup) From eb025ae43d5a71ddc75703db26fa114a504e7404 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 26 Feb 2026 18:35:06 +0000 Subject: [PATCH 3/3] Add install.sh automated installation script and update docs Co-authored-by: luisespersonal-byte <249453885+luisespersonal-byte@users.noreply.github.com> --- INSTALL_ES.md | 20 +++++++- README.md | 12 ++++- install.sh | 136 ++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 166 insertions(+), 2 deletions(-) create mode 100755 install.sh diff --git a/INSTALL_ES.md b/INSTALL_ES.md index f2e757b0..442f9ebe 100644 --- a/INSTALL_ES.md +++ b/INSTALL_ES.md @@ -33,7 +33,25 @@ Para funciones de chat y "Prompt to Code": > Si te preocupa el registro de teclas y no puedes confiar en el binario, recomendamos revisar el código y [compilarlo tú mismo](DEVELOPMENT.md). -## Instalación y Configuración +## Instalación Automática + +Para instalar automáticamente con un solo comando, ejecuta esto en la **Terminal**: + +```bash +bash <(curl -fsSL https://raw.githubusercontent.com/intitni/CopilotForXcode/main/install.sh) +``` + +El script comprobará los requisitos previos, instalará la app mediante Homebrew (si está disponible) y te guiará paso a paso por las acciones manuales necesarias. + +Si ya tienes el repositorio clonado localmente, también puedes ejecutar: + +```bash +bash install.sh +``` + +--- + +## Instalación y Configuración Manual > El proceso de instalación puede parecer complejo al principio. Aquí tienes un resumen rápido: > diff --git a/README.md b/README.md index 9c36004b..44effff0 100644 --- a/README.md +++ b/README.md @@ -91,7 +91,17 @@ For chat and prompt to code features: > 4. Setup accounts and models in the host app. > 5. Optionally, update the settings of each feature in the host app, and setup keybindings. -### Install +### Automated Install + +Run the following command in Terminal to install automatically: + +```bash +bash <(curl -fsSL https://raw.githubusercontent.com/intitni/CopilotForXcode/main/install.sh) +``` + +The script checks prerequisites, installs the app via Homebrew (if available), and guides you through the required manual steps. + +### Manual Install You can install it via [Homebrew](http://brew.sh/): diff --git a/install.sh b/install.sh new file mode 100755 index 00000000..5c47eb7f --- /dev/null +++ b/install.sh @@ -0,0 +1,136 @@ +#!/usr/bin/env bash +# install.sh — Automated installer for Copilot for Xcode +# https://github.com/intitni/CopilotForXcode +# +# Usage: +# curl -fsSL https://raw.githubusercontent.com/intitni/CopilotForXcode/main/install.sh | bash +# or, if you have already cloned the repo: +# bash install.sh + +set -euo pipefail + +# ── Constants ───────────────────────────────────────────────────────────────── +MIN_MACOS_MAJOR=13 + +# ── Colour helpers ──────────────────────────────────────────────────────────── +RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m' +CYAN='\033[0;36m'; BOLD='\033[1m'; NC='\033[0m' + +info() { echo -e "${CYAN}[INFO]${NC} $*"; } +success() { echo -e "${GREEN}[OK]${NC} $*"; } +warn() { echo -e "${YELLOW}[WARN]${NC} $*"; } +error() { echo -e "${RED}[ERROR]${NC} $*" >&2; } +step() { echo -e "\n${BOLD}▶ $*${NC}"; } +manual() { echo -e "${YELLOW} ➤ MANUAL STEP REQUIRED:${NC} $*"; } + +# ── Step 0: Platform check ──────────────────────────────────────────────────── +step "Checking platform" + +if [[ "$(uname)" != "Darwin" ]]; then + error "Copilot for Xcode requires macOS. This system is $(uname)." + exit 1 +fi + +MACOS_VERSION=$(sw_vers -productVersion) +MACOS_MAJOR=$(echo "$MACOS_VERSION" | cut -d. -f1) +MACOS_MINOR=$(echo "$MACOS_VERSION" | cut -d. -f2) + +if [[ "$MACOS_MAJOR" -lt $MIN_MACOS_MAJOR ]]; then + error "macOS $MIN_MACOS_MAJOR (Ventura) or later is required. Found: $MACOS_VERSION" + exit 1 +fi + +success "macOS $MACOS_VERSION detected (requirement: $MIN_MACOS_MAJOR+)" + +# ── Step 1: Install via Homebrew (preferred) ────────────────────────────────── +step "Installing Copilot for Xcode" + +if command -v brew &>/dev/null; then + info "Homebrew found. Installing via 'brew install --cask copilot-for-xcode' ..." + if brew install --cask copilot-for-xcode; then + success "Copilot for Xcode installed via Homebrew." + else + error "Homebrew installation failed." + echo + echo " Fallback — Download manually:" + echo " https://github.com/intitni/CopilotForXcode/releases/latest" + echo " Then move 'Copilot for Xcode.app' into /Applications." + echo + read -rp " Press ENTER once the app is in /Applications to continue ..." + fi +else + warn "Homebrew is not installed." + echo + echo " Option A — Install Homebrew first, then re-run this script:" + echo " /bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"" + echo + echo " Option B — Download manually:" + echo " https://github.com/intitni/CopilotForXcode/releases/latest" + echo " Then move 'Copilot for Xcode.app' into /Applications." + echo + read -rp " Press ENTER once the app is in /Applications to continue ..." +fi + +# ── Step 2: Verify the app exists and open it ───────────────────────────────── +step "Opening Copilot for Xcode" + +APP_PATH="/Applications/Copilot for Xcode.app" + +if [[ ! -d "$APP_PATH" ]]; then + error "Could not find '$APP_PATH'. Make sure the app is in the Applications folder." + exit 1 +fi + +open "$APP_PATH" +success "Copilot for Xcode launched. It will register its background service automatically." + +# ── Step 3: Node.js check ───────────────────────────────────────────────────── +step "Checking Node.js (required for GitHub Copilot suggestions)" + +if command -v node &>/dev/null; then + NODE_VERSION=$(node --version) + success "Node.js $NODE_VERSION found at $(command -v node)" +else + warn "Node.js was not found in PATH." + echo + echo " Node.js is required to use GitHub Copilot suggestions." + echo " Install it from https://nodejs.org/ or via Homebrew:" + echo " brew install node" +fi + +# ── Step 4: Manual steps summary ───────────────────────────────────────────── +step "Manual steps required after installation" + +MACOS_DISPLAY="macOS $MACOS_MAJOR.$MACOS_MINOR" + +echo +echo " The following steps cannot be automated and must be done manually:" +echo + +echo " 1. Enable the Xcode Source Editor Extension in System Settings:" +if [[ "$MACOS_MAJOR" -ge 15 ]]; then + manual "System Settings → General → Login Items & Extensions → Xcode Source Editor → tick 'Copilot for Xcode'" +elif [[ "$MACOS_MAJOR" -eq 14 ]]; then + manual "System Settings → Privacy & Security → Extensions → Xcode Source Editor → tick 'Copilot'" +else + manual "System Preferences → Extensions → tick 'Copilot'" +fi + +echo +echo " 2. Grant Accessibility API permission:" +manual "System Settings → Privacy & Security → Accessibility → add 'CopilotForXcodeExtensionService.app'" +echo " (Click 'Reveal Extension App in Finder' inside Copilot for Xcode.app to locate it.)" + +echo +echo " 3. Sign in to GitHub Copilot inside the app:" +manual "Open Copilot for Xcode → Service → GitHub Copilot → Install → Sign In" + +echo +echo " 4. (Optional) Set up key bindings in Xcode:" +manual "Xcode → Settings → Key Bindings → search 'copilot'" + +echo +success "Installation complete! Follow the manual steps above, then restart Xcode." +echo +echo -e " ${CYAN}Full guide:${NC} https://github.com/intitni/CopilotForXcode#installation-and-setup" +echo -e " ${CYAN}Guía en español:${NC} https://github.com/intitni/CopilotForXcode/blob/main/INSTALL_ES.md"