#!/usr/bin/env bash
set -euo pipefail
# Colors and formatting
if [[ -t 1 ]] && [[ "${TERM:-}" != "dumb" ]]; then
BOLD='\033[1m'
DIM='\033[2m'
RESET='\033[0m'
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[0;33m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
else
BOLD=''
DIM=''
RESET=''
RED=''
GREEN=''
YELLOW=''
BLUE=''
CYAN=''
fi
# Symbols
CHECK="${GREEN}✓${RESET}"
CROSS="${RED}✗${RESET}"
ARROW="${CYAN}→${RESET}"
WARN="${YELLOW}!${RESET}"
print_header() {
printf "\n"
printf "${BOLD}${BLUE}╭──────────────────────────────────╮${RESET}\n"
printf "${BOLD}${BLUE}│${RESET} ${BOLD}XcodeBuildMCP Skill Installer${RESET} ${BOLD}${BLUE}│${RESET}\n"
printf "${BOLD}${BLUE}╰──────────────────────────────────╯${RESET}\n"
}
print_success() {
printf " ${CHECK} ${GREEN}%s${RESET}\n" "$1"
}
print_error() {
printf " ${CROSS} ${RED}%s${RESET}\n" "$1" >&2
}
print_warning() {
printf " ${WARN} ${YELLOW}%s${RESET}\n" "$1"
}
print_info() {
printf " ${ARROW} %s\n" "$1"
}
print_step() {
printf "\n${BOLD}%s${RESET}\n" "$1"
}
usage() {
cat <<EOF
${BOLD}Usage:${RESET} install-skill.sh --codex|--claude|--cursor|--dest <path> [options]
${BOLD}Options:${RESET}
--codex Install to Codex skills directory
--claude Install to Claude skills directory
--cursor Install to Cursor skills directory
--dest <path> Install to custom directory
--skill <mcp|cli> Skill to install (prompted if omitted)
--ref <git-ref> Git ref to download from (default: main)
--remove-conflict Auto-remove conflicting skill
-h, --help Show this help message
${BOLD}Description:${RESET}
Installs the XcodeBuildMCP skill for your AI coding assistant.
If run from a local checkout, installs the local skill file.
Otherwise downloads from GitHub.
EOF
}
destination=""
skill_choice=""
skill_ref_override=""
remove_conflict="false"
script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
repo_root="$(cd "${script_dir}/.." && pwd)"
while [[ $# -gt 0 ]]; do
case "$1" in
--codex)
destination="${HOME}/.codex/skills/public"
shift
;;
--claude)
destination="${HOME}/.claude/skills"
shift
;;
--cursor)
destination="${HOME}/.cursor/skills"
shift
;;
--dest)
if [[ $# -lt 2 ]]; then
echo "Missing value for --dest" >&2
usage
exit 1
fi
destination="$2"
shift 2
;;
--skill)
if [[ $# -lt 2 ]]; then
echo "Missing value for --skill" >&2
usage
exit 1
fi
skill_choice="$2"
shift 2
;;
--ref)
if [[ $# -lt 2 ]]; then
echo "Missing value for --ref" >&2
usage
exit 1
fi
skill_ref_override="$2"
shift 2
;;
--remove-conflict)
remove_conflict="true"
shift
;;
-h|--help)
usage
exit 0
;;
*)
echo "Unknown option: $1" >&2
usage
exit 1
;;
esac
done
prompt_for_destination() {
print_step "Select Target Client"
while true; do
printf "\n"
printf " ${CYAN}[1]${RESET} Codex\n"
printf " ${CYAN}[2]${RESET} Claude\n"
printf " ${CYAN}[3]${RESET} Cursor\n"
printf "\n"
printf " ${DIM}Enter your choice${RESET} ${BOLD}[1-3]:${RESET} "
read -r selection
case "${selection}" in
1)
destination="${HOME}/.codex/skills/public"
print_success "Selected Codex"
return 0
;;
2)
destination="${HOME}/.claude/skills"
print_success "Selected Claude"
return 0
;;
3)
destination="${HOME}/.cursor/skills"
print_success "Selected Cursor"
return 0
;;
*)
print_error "Invalid selection. Please enter 1, 2, or 3."
;;
esac
done
}
prompt_for_skill() {
print_step "Select Skill Type"
while true; do
printf "\n"
printf " ${CYAN}[1]${RESET} XcodeBuildMCP ${DIM}(MCP server)${RESET}\n"
printf " ${DIM}Full MCP integration with all tools${RESET}\n"
printf "\n"
printf " ${CYAN}[2]${RESET} XcodeBuildMCP CLI\n"
printf " ${DIM}Lightweight CLI-based commands${RESET}\n"
printf "\n"
printf " ${DIM}Enter your choice${RESET} ${BOLD}[1-2]:${RESET} "
read -r selection
case "${selection}" in
1)
skill_choice="mcp"
print_success "Selected MCP server skill"
return 0
;;
2)
skill_choice="cli"
print_success "Selected CLI skill"
return 0
;;
*)
print_error "Invalid selection. Please enter 1 or 2."
;;
esac
done
}
print_header
if [[ -z "${destination}" ]]; then
prompt_for_destination
fi
if [[ -z "${skill_choice}" ]]; then
prompt_for_skill
fi
case "${skill_choice}" in
mcp|server|xcodebuildmcp)
skill_dir_name="xcodebuildmcp"
skill_label="XcodeBuildMCP (MCP server)"
alt_dir_name="xcodebuildmcp-cli"
alt_label="XcodeBuildMCP CLI"
;;
cli|xcodebuildmcp-cli)
skill_dir_name="xcodebuildmcp-cli"
skill_label="XcodeBuildMCP CLI"
alt_dir_name="xcodebuildmcp"
alt_label="XcodeBuildMCP (MCP server)"
;;
*)
echo "Unknown skill: ${skill_choice}" >&2
usage
exit 1
;;
esac
skill_dir="${destination}/${skill_dir_name}"
alt_dir="${destination}/${alt_dir_name}"
skill_path="skills/${skill_dir_name}/SKILL.md"
skill_base_url="https://raw.githubusercontent.com/getsentry/XcodeBuildMCP"
skill_ref="main"
if [[ -n "${skill_ref_override}" ]]; then
skill_ref="${skill_ref_override}"
fi
print_step "Installing"
if [[ -e "${alt_dir}" ]]; then
if [[ "${remove_conflict}" == "true" ]]; then
rm -r "${alt_dir}"
print_info "Removed conflicting skill: ${alt_label}"
else
printf "\n"
print_warning "Conflict detected!"
printf " ${DIM}Only one skill can be installed at a time.${RESET}\n"
printf " ${DIM}Found:${RESET} ${alt_label}\n"
printf " ${DIM}Path:${RESET} ${alt_dir}\n"
printf "\n"
printf " ${BOLD}Remove existing skill to continue?${RESET} ${DIM}[y/N]:${RESET} "
read -r confirm
case "${confirm}" in
y|Y|yes|YES)
rm -r "${alt_dir}"
print_success "Removed ${alt_label}"
;;
*)
print_error "Installation cancelled"
exit 1
;;
esac
fi
fi
if [[ -e "${skill_dir}" ]]; then
rm -r "${skill_dir}"
print_info "Replacing existing installation"
fi
mkdir -p "${skill_dir}"
primary_url="${skill_base_url}/${skill_ref}/${skill_path}"
fallback_url="${skill_base_url}/main/${skill_path}"
local_skill_path="${repo_root}/${skill_path}"
if [[ -f "${local_skill_path}" ]]; then
cp "${local_skill_path}" "${skill_dir}/SKILL.md"
print_info "Installed from local checkout"
else
print_info "Downloading from GitHub..."
if ! curl -fsSL "${primary_url}" -o "${skill_dir}/SKILL.md" 2>/dev/null; then
if [[ "${skill_ref}" != "main" ]]; then
print_warning "Tag ${skill_ref} not found, falling back to main"
if ! curl -fsSL "${fallback_url}" -o "${skill_dir}/SKILL.md" 2>/dev/null; then
print_error "Failed to download skill"
exit 1
fi
else
print_error "Failed to download skill"
exit 1
fi
fi
fi
printf "\n"
printf "${BOLD}${GREEN}╭─────────────────────────────────────╮${RESET}\n"
printf "${BOLD}${GREEN}│${RESET} ${CHECK} ${BOLD}Installation Complete${RESET} ${BOLD}${GREEN}│${RESET}\n"
printf "${BOLD}${GREEN}╰─────────────────────────────────────╯${RESET}\n"
printf "\n"
printf " ${BOLD}Skill:${RESET} %s\n" "${skill_label}"
printf " ${BOLD}Location:${RESET} %s\n" "${skill_dir}"
printf "\n"
