@dmsdc-ai/aigentry-devkit 0.1.0

package/config/envrc/global.envrc

@@ -0,0 +1,3 @@
+# Global environment variables
+# Loaded by direnv for all directories under ~/
+dotenv_if_exists "$HOME/.env"

package/config/settings.json.template

@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": [],
+    "deny": []
+  },
+  "env": {
+    "CLAUDE_CODE_ENABLE_STATUSLINE": "1",
+    "CLAUDE_CODE_STATUSLINE_COMMAND": "bash {{HOME}}/.claude/hud/simple-status.sh"
+  },
+  "plugins": [],
+  "skipDangerousModePermissionPrompt": false
+}

package/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash '${CLAUDE_PLUGIN_ROOT}/hooks/session-start'",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/session-start

@@ -0,0 +1,37 @@
+#!/bin/bash
+#
+# Session start hook — load bootstrap context
+#
+# Injects the available skills list into the conversation context
+# so the agent knows what capabilities are available.
+#
+
+PLUGIN_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+SKILLS_DIR="$PLUGIN_ROOT/skills"
+
+# Build skills index
+SKILLS_LIST=""
+for skill_dir in "$SKILLS_DIR"/*/; do
+  [ -d "$skill_dir" ] || continue
+  skill_name=$(basename "$skill_dir")
+  skill_file="$skill_dir/SKILL.md"
+  if [ -f "$skill_file" ]; then
+    # Extract description from YAML frontmatter
+    desc=$(sed -n '/^---$/,/^---$/p' "$skill_file" | grep -E '^\s*description:' | head -1 | sed 's/.*description:\s*//' | head -c 100)
+    SKILLS_LIST="$SKILLS_LIST\n- **$skill_name**: $desc"
+  fi
+done
+
+if [ -z "$SKILLS_LIST" ]; then
+  exit 0
+fi
+
+CONTEXT="aigentry-devkit: Available skills:$SKILLS_LIST\n\nUse the Skill tool to invoke any skill by name."
+
+# Output in Claude Code hook format
+ESCAPED=$(echo -e "$CONTEXT" | node -e '
+  let d=""; process.stdin.on("data",c=>d+=c);
+  process.stdin.on("end",()=>console.log(JSON.stringify(d)));
+' 2>/dev/null)
+
+echo "{\"hookSpecificOutput\":{\"additionalContext\":$ESCAPED}}"

package/hud/simple-status.sh

@@ -0,0 +1,126 @@
+#!/bin/bash
+# Simple statusline: reads Claude Code stdin JSON for real-time token display
+# Claude Code pipes JSON via stdin with model, context_window, cwd data.
+
+# Read stdin JSON
+STDIN=$(cat)
+
+# Parse JSON fields with jq (fallback to defaults if missing)
+CWD=$(echo "$STDIN" | jq -r '.cwd // empty' 2>/dev/null)
+CWD="${CWD:-$PWD}"
+CWD=$(basename "$CWD")
+
+MODEL=$(echo "$STDIN" | jq -r '.model.display_name // .model.id // "Unknown"' 2>/dev/null)
+
+# Context window data
+WINDOW_SIZE=$(echo "$STDIN" | jq -r '.context_window.context_window_size // 0' 2>/dev/null)
+MODEL_ID=$(echo "$STDIN" | jq -r '.model.id // ""' 2>/dev/null)
+
+# Max plan: use reported context window (200K) as-is
+
+USED_PCT=$(echo "$STDIN" | jq -r '.context_window.used_percentage // empty' 2>/dev/null)
+
+# Token usage from current_usage
+INPUT_TOKENS=$(echo "$STDIN" | jq -r '.context_window.current_usage.input_tokens // 0' 2>/dev/null)
+CACHE_CREATE=$(echo "$STDIN" | jq -r '.context_window.current_usage.cache_creation_input_tokens // 0' 2>/dev/null)
+CACHE_READ=$(echo "$STDIN" | jq -r '.context_window.current_usage.cache_read_input_tokens // 0' 2>/dev/null)
+
+# Total used tokens
+USED=$((INPUT_TOKENS + CACHE_CREATE + CACHE_READ))
+
+# Calculate percentage
+if [ -n "$USED_PCT" ] && [ "$USED_PCT" != "null" ]; then
+  PCT=$(printf '%.0f' "$USED_PCT" 2>/dev/null || echo 0)
+elif [ "$WINDOW_SIZE" -gt 0 ] 2>/dev/null; then
+  PCT=$((USED * 100 / WINDOW_SIZE))
+else
+  PCT=0
+fi
+
+# Clamp percentage
+[ "$PCT" -gt 100 ] 2>/dev/null && PCT=100
+[ "$PCT" -lt 0 ] 2>/dev/null && PCT=0
+
+# Format token counts (e.g. 48000 -> 48.0K, 1500000 -> 1.50M)
+format_tokens() {
+  local n=$1
+  if [ "$n" -ge 1000000 ] 2>/dev/null; then
+    local m=$((n / 10000))
+    echo "$((m / 100)).$((m % 100))M"
+  elif [ "$n" -ge 1000 ] 2>/dev/null; then
+    local k=$((n / 100))
+    echo "$((k / 10)).$((k % 10))K"
+  else
+    echo "${n}"
+  fi
+}
+
+USED_FMT=$(format_tokens "$USED")
+WINDOW_FMT=$(format_tokens "$WINDOW_SIZE")
+
+# Color codes
+GREEN='\033[32m'
+YELLOW='\033[33m'
+RED='\033[31m'
+DIM='\033[2m'
+RESET='\033[0m'
+
+# Select color based on percentage
+if [ "$PCT" -ge 85 ]; then
+  COLOR="$RED"
+elif [ "$PCT" -ge 70 ]; then
+  COLOR="$YELLOW"
+else
+  COLOR="$GREEN"
+fi
+
+# Build progress bar (15 chars wide)
+BAR_WIDTH=15
+FILLED=$((PCT * BAR_WIDTH / 100))
+[ "$FILLED" -lt 0 ] 2>/dev/null && FILLED=0
+EMPTY=$((BAR_WIDTH - FILLED))
+
+FILLED_BAR=""
+EMPTY_BAR=""
+if [ "$FILLED" -gt 0 ]; then
+  FILLED_BAR=$(printf '%0.s█' $(seq 1 "$FILLED"))
+fi
+if [ "$EMPTY" -gt 0 ]; then
+  EMPTY_BAR=$(printf '%0.s░' $(seq 1 "$EMPTY"))
+fi
+
+# PSM Session Detection
+PSM_SESSION=""
+PSM_NOTIFICATIONS=0
+FULL_CWD=$(echo "$STDIN" | jq -r '.cwd // empty' 2>/dev/null)
+FULL_CWD="${FULL_CWD:-$PWD}"
+
+if [ -f "${FULL_CWD}/.psm-session.json" ]; then
+  PSM_SESSION=$(jq -r '.session_id // empty' "${FULL_CWD}/.psm-session.json" 2>/dev/null)
+  PSM_TYPE=$(jq -r '.type // empty' "${FULL_CWD}/.psm-session.json" 2>/dev/null)
+  PSM_BRANCH=$(jq -r '.branch // empty' "${FULL_CWD}/.psm-session.json" 2>/dev/null)
+
+  # Check for pending notifications
+  NOTIFY_FILE="${FULL_CWD}/.psm-notifications/pending.log"
+  if [ -f "$NOTIFY_FILE" ] && [ -s "$NOTIFY_FILE" ]; then
+    PSM_NOTIFICATIONS=$(wc -l < "$NOTIFY_FILE" | tr -d ' ')
+  fi
+fi
+
+# Build PSM suffix
+PSM_SUFFIX=""
+if [ -n "$PSM_SESSION" ]; then
+  CYAN='\033[36m'
+  if [ "$PSM_NOTIFICATIONS" -gt 0 ]; then
+    PSM_SUFFIX=$(printf ' | %bPSM:%s [%s] %b%d notif%b' "$CYAN" "$PSM_SESSION" "$PSM_BRANCH" "$YELLOW" "$PSM_NOTIFICATIONS" "$RESET")
+  else
+    PSM_SUFFIX=$(printf ' | %bPSM:%s [%s]%b' "$CYAN" "$PSM_SESSION" "$PSM_BRANCH" "$RESET")
+  fi
+fi
+
+# Output: cwd | model | [████░░░░░░] 5% 45.2K/1.0M | PSM:session [branch]
+printf '%s | %s | [%b%s%b%s%b] %b%d%% %s/%s%b%b\n' \
+  "$CWD" "$MODEL" \
+  "$COLOR" "$FILLED_BAR" "$DIM" "$EMPTY_BAR" "$RESET" \
+  "$COLOR" "$PCT" "$USED_FMT" "$WINDOW_FMT" "$RESET" \
+  "$PSM_SUFFIX"

package/install.ps1

@@ -0,0 +1,203 @@
+param(
+  [switch]$Force
+)
+
+$ErrorActionPreference = "Stop"
+
+$DevkitDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ClaudeDir = Join-Path $HOME ".claude"
+$McpDest = Join-Path $HOME ".local\lib\mcp-deliberation"
+
+function Write-Info([string]$Message) {
+  Write-Host "[+] $Message" -ForegroundColor Green
+}
+
+function Write-Warn([string]$Message) {
+  Write-Host "[!] $Message" -ForegroundColor Yellow
+}
+
+function Write-Header([string]$Message) {
+  Write-Host ""
+  Write-Host $Message -ForegroundColor Cyan
+}
+
+Write-Host ""
+Write-Host "  ===============================================" -ForegroundColor Cyan
+Write-Host "   aigentry-devkit installer (PowerShell)" -ForegroundColor Cyan
+Write-Host "   AI Development Environment Kit" -ForegroundColor Cyan
+Write-Host "  ===============================================" -ForegroundColor Cyan
+Write-Host ""
+
+Write-Header "1. Prerequisites"
+
+$nodeCmd = Get-Command node -ErrorAction SilentlyContinue
+if (-not $nodeCmd) {
+  Write-Warn "node not found. Install Node.js 18+ first."
+  exit 1
+}
+Write-Info "Node.js $(& node -v) found"
+
+$npmCmd = Get-Command npm -ErrorAction SilentlyContinue
+if (-not $npmCmd) {
+  Write-Warn "npm not found. Install Node.js (npm included)."
+  exit 1
+}
+
+if (Get-Command tmux -ErrorAction SilentlyContinue) {
+  Write-Info "tmux found (deliberation monitor can run in tmux)"
+} else {
+  Write-Warn "tmux not found. Deliberation monitor auto-window is disabled."
+}
+
+if (Get-Command claude -ErrorAction SilentlyContinue) {
+  Write-Info "Claude Code CLI found"
+} else {
+  Write-Warn "Claude Code CLI not found. Install with: npm install -g @anthropic-ai/claude-code"
+}
+
+Write-Header "2. Skills"
+
+$skillsDest = Join-Path $ClaudeDir "skills"
+New-Item -ItemType Directory -Path $skillsDest -Force | Out-Null
+
+$skillDirs = Get-ChildItem (Join-Path $DevkitDir "skills") -Directory
+foreach ($skillDir in $skillDirs) {
+  $skillName = $skillDir.Name
+  $target = Join-Path $skillsDest $skillName
+
+  if (Test-Path $target) {
+    if ($Force) {
+      Remove-Item -Recurse -Force $target
+    } else {
+      Write-Warn "$skillName already exists (skipping, use -Force to overwrite)"
+      continue
+    }
+  }
+
+  Copy-Item -Path $skillDir.FullName -Destination $target -Recurse
+  Write-Info "Installed skill: $skillName"
+}
+
+Write-Header "3. HUD Statusline"
+
+$hudDest = Join-Path $ClaudeDir "hud"
+New-Item -ItemType Directory -Path $hudDest -Force | Out-Null
+$hudTarget = Join-Path $hudDest "simple-status.sh"
+$hudSource = Join-Path $DevkitDir "hud\simple-status.sh"
+
+if (-not (Test-Path $hudTarget) -or $Force) {
+  Copy-Item -Path $hudSource -Destination $hudTarget -Force
+  Write-Info "Installed HUD: simple-status.sh"
+} else {
+  Write-Warn "HUD already exists (use -Force to overwrite)"
+}
+
+Write-Header "4. MCP Deliberation Server"
+
+New-Item -ItemType Directory -Path $McpDest -Force | Out-Null
+Copy-Item -Path (Join-Path $DevkitDir "mcp-servers\deliberation\index.js") -Destination (Join-Path $McpDest "index.js") -Force
+Copy-Item -Path (Join-Path $DevkitDir "mcp-servers\deliberation\package.json") -Destination (Join-Path $McpDest "package.json") -Force
+Copy-Item -Path (Join-Path $DevkitDir "mcp-servers\deliberation\session-monitor.sh") -Destination (Join-Path $McpDest "session-monitor.sh") -Force
+
+Write-Info "Installing dependencies..."
+Push-Location $McpDest
+npm install --silent | Out-Null
+Pop-Location
+Write-Info "MCP deliberation server installed at $McpDest"
+
+Write-Header "5. MCP Registration"
+
+$mcpConfig = Join-Path $ClaudeDir ".mcp.json"
+New-Item -ItemType Directory -Path $ClaudeDir -Force | Out-Null
+
+if (Test-Path $mcpConfig) {
+  try {
+    $cfg = Get-Content $mcpConfig -Raw | ConvertFrom-Json
+  } catch {
+    $cfg = [pscustomobject]@{}
+  }
+} else {
+  $cfg = [pscustomobject]@{}
+}
+
+if (-not $cfg.PSObject.Properties.Name.Contains("mcpServers")) {
+  $cfg | Add-Member -MemberType NoteProperty -Name mcpServers -Value ([pscustomobject]@{})
+}
+
+$cfg.mcpServers | Add-Member -MemberType NoteProperty -Name deliberation -Value ([pscustomobject]@{
+  command = "node"
+  args = @((Join-Path $McpDest "index.js"))
+}) -Force
+
+$cfg | ConvertTo-Json -Depth 8 | Set-Content -Path $mcpConfig -Encoding utf8
+Write-Info "Registered deliberation MCP in $mcpConfig"
+
+Write-Header "6. Config Templates"
+
+$settingsDest = Join-Path $ClaudeDir "settings.json"
+$settingsTemplate = Join-Path $DevkitDir "config\settings.json.template"
+if (-not (Test-Path $settingsDest)) {
+  if (Test-Path $settingsTemplate) {
+    (Get-Content $settingsTemplate -Raw).Replace("{{HOME}}", $HOME) | Set-Content -Path $settingsDest -Encoding utf8
+    Write-Info "Created settings.json from template"
+  }
+} else {
+  Write-Info "settings.json already exists (skipping)"
+}
+
+if (Get-Command direnv -ErrorAction SilentlyContinue) {
+  $globalEnvrc = Join-Path $HOME ".envrc"
+  if (-not (Test-Path $globalEnvrc)) {
+    Copy-Item -Path (Join-Path $DevkitDir "config\envrc\global.envrc") -Destination $globalEnvrc
+    Write-Info "Installed global .envrc"
+  } else {
+    Write-Info "Global .envrc already exists (skipping)"
+  }
+} else {
+  Write-Warn "direnv not found. Skipping .envrc setup."
+}
+
+Write-Header "7. Codex Integration (optional)"
+
+if (Get-Command codex -ErrorAction SilentlyContinue) {
+  try {
+    codex mcp add deliberation -- node (Join-Path $McpDest "index.js") | Out-Null
+    Write-Info "Registered deliberation MCP in Codex"
+  } catch {
+    Write-Warn "Codex MCP registration failed (may already exist)"
+  }
+
+  try {
+    $codexList = codex mcp list 2>$null
+    if ($codexList -match "deliberation") {
+      Write-Info "Codex MCP verification passed (deliberation found)"
+    } else {
+      Write-Warn "Codex MCP verification failed. Run manually: codex mcp add deliberation -- node $McpDest\index.js"
+    }
+  } catch {
+    Write-Warn "Codex MCP verification failed (codex mcp list unavailable)"
+  }
+} else {
+  Write-Warn "Codex CLI not found. Skipping Codex integration."
+}
+
+Write-Header "8. Cross-platform Notes"
+Write-Info "Codex is a deliberation participant CLI, not a separate MCP server."
+Write-Info "Browser LLM tab detection uses macOS automation + CDP scan."
+Write-Info "On Windows/Linux, start browser with --remote-debugging-port=9222 for automatic tab scan."
+Write-Info "Fallback always works: prepare_turn -> paste to browser LLM -> submit_turn."
+
+Write-Header "Installation Complete!"
+Write-Host ""
+Write-Host "  Installed components:"
+Write-Host "    Skills:     $((Get-ChildItem $skillsDest -Directory -ErrorAction SilentlyContinue | Measure-Object).Count) skills in $skillsDest"
+Write-Host "    HUD:        $hudTarget"
+Write-Host "    MCP Server: $McpDest"
+Write-Host "    Config:     $ClaudeDir"
+Write-Host ""
+Write-Host "  Next steps:"
+Write-Host "    1. Restart Claude/Codex processes to load new MCP settings"
+Write-Host "    2. If browser tab scan is empty, enable browser remote debugging port"
+Write-Host "    3. For updates, rerun install.ps1 -Force"
+Write-Host ""
+Write-Host "  Enjoy your AI development environment!"

package/install.sh

@@ -0,0 +1,213 @@
+#!/bin/bash
+set -euo pipefail
+
+#
+# aigentry-devkit installer
+#
+# Usage:
+#   git clone https://github.com/dmsdc-ai/aigentry-devkit.git
+#   cd aigentry-devkit && bash install.sh
+#
+
+DEVKIT_DIR="$(cd "$(dirname "$0")" && pwd)"
+CLAUDE_DIR="$HOME/.claude"
+MCP_DEST="$HOME/.local/lib/mcp-deliberation"
+PLATFORM="$(uname -s 2>/dev/null || echo unknown)"
+
+# 색상
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+info()  { echo -e "${GREEN}[+]${NC} $1"; }
+warn()  { echo -e "${YELLOW}[!]${NC} $1"; }
+header() { echo -e "\n${BOLD}${CYAN}$1${NC}"; }
+
+echo -e "${BOLD}"
+echo "  ╔═══════════════════════════════════════╗"
+echo "  ║     aigentry-devkit installer          ║"
+echo "  ║     AI Development Environment Kit     ║"
+echo "  ╚═══════════════════════════════════════╝"
+echo -e "${NC}"
+
+# ── 사전 요구사항 확인 ──
+header "1. Prerequisites"
+
+command -v node >/dev/null 2>&1 || { warn "node not found. Install Node.js 18+"; exit 1; }
+command -v npm >/dev/null 2>&1 || { warn "npm not found. Install Node.js 18+"; exit 1; }
+info "Node.js $(node -v) found"
+info "Platform: $PLATFORM"
+
+case "$PLATFORM" in
+  MINGW*|MSYS*|CYGWIN*)
+    warn "Windows shell detected. Prefer PowerShell installer: powershell -ExecutionPolicy Bypass -File .\\install.ps1"
+    ;;
+esac
+
+if command -v tmux >/dev/null 2>&1; then
+  info "tmux found (deliberation monitor will use it)"
+else
+  warn "tmux not found. Deliberation monitor terminals won't auto-open."
+fi
+
+if command -v claude >/dev/null 2>&1; then
+  info "Claude Code CLI found"
+else
+  warn "Claude Code CLI not found. Install: npm install -g @anthropic-ai/claude-code"
+fi
+
+# ── Skills 설치 ──
+header "2. Skills"
+
+SKILLS_DEST="$CLAUDE_DIR/skills"
+mkdir -p "$SKILLS_DEST"
+
+for skill_dir in "$DEVKIT_DIR"/skills/*/; do
+  skill_name=$(basename "$skill_dir")
+  target="$SKILLS_DEST/$skill_name"
+
+  if [ -L "$target" ]; then
+    rm "$target"
+  fi
+
+  if [ -d "$target" ]; then
+    warn "$skill_name already exists (skipping, use --force to overwrite)"
+    continue
+  fi
+
+  ln -s "$skill_dir" "$target"
+  info "Linked skill: $skill_name"
+done
+
+# ── HUD / Statusline ──
+header "3. HUD Statusline"
+
+HUD_DEST="$CLAUDE_DIR/hud"
+mkdir -p "$HUD_DEST"
+
+if [ ! -f "$HUD_DEST/simple-status.sh" ] || [ "${1:-}" = "--force" ]; then
+  cp "$DEVKIT_DIR/hud/simple-status.sh" "$HUD_DEST/simple-status.sh"
+  chmod +x "$HUD_DEST/simple-status.sh"
+  info "Installed HUD: simple-status.sh"
+else
+  warn "HUD already exists (use --force to overwrite)"
+fi
+
+# ── MCP Deliberation Server ──
+header "4. MCP Deliberation Server"
+
+mkdir -p "$MCP_DEST"
+cp "$DEVKIT_DIR/mcp-servers/deliberation/index.js" "$MCP_DEST/"
+cp "$DEVKIT_DIR/mcp-servers/deliberation/package.json" "$MCP_DEST/"
+cp "$DEVKIT_DIR/mcp-servers/deliberation/session-monitor.sh" "$MCP_DEST/"
+chmod +x "$MCP_DEST/session-monitor.sh"
+
+info "Installing dependencies..."
+(cd "$MCP_DEST" && npm install --silent 2>/dev/null)
+info "MCP deliberation server installed at $MCP_DEST"
+
+# ── MCP 등록 ──
+header "5. MCP Registration"
+
+MCP_CONFIG="$CLAUDE_DIR/.mcp.json"
+
+if [ -f "$MCP_CONFIG" ]; then
+  # deliberation 서버가 이미 등록되어 있는지 확인
+  if node -e "const c=JSON.parse(require('fs').readFileSync('$MCP_CONFIG','utf-8'));process.exit(c.mcpServers?.deliberation?0:1)" 2>/dev/null; then
+    info "Deliberation MCP already registered"
+  else
+    # 기존 설정에 deliberation 추가
+    node -e "
+      const fs = require('fs');
+      const c = JSON.parse(fs.readFileSync('$MCP_CONFIG', 'utf-8'));
+      if (!c.mcpServers) c.mcpServers = {};
+      c.mcpServers.deliberation = {
+        command: 'node',
+        args: ['$MCP_DEST/index.js']
+      };
+      fs.writeFileSync('$MCP_CONFIG', JSON.stringify(c, null, 2));
+    "
+    info "Registered deliberation MCP in $MCP_CONFIG"
+  fi
+else
+  # 새로 생성
+  cat > "$MCP_CONFIG" << MCPEOF
+{
+  "mcpServers": {
+    "deliberation": {
+      "command": "node",
+      "args": ["$MCP_DEST/index.js"]
+    }
+  }
+}
+MCPEOF
+  info "Created $MCP_CONFIG with deliberation MCP"
+fi
+
+# ── Config 템플릿 ──
+header "6. Config Templates"
+
+# settings.json
+SETTINGS_DEST="$CLAUDE_DIR/settings.json"
+if [ ! -f "$SETTINGS_DEST" ]; then
+  SETTINGS_TEMPLATE="$DEVKIT_DIR/config/settings.json.template"
+  if [ -f "$SETTINGS_TEMPLATE" ]; then
+    sed "s|{{HOME}}|$HOME|g" "$SETTINGS_TEMPLATE" > "$SETTINGS_DEST"
+    info "Created settings.json from template"
+  fi
+else
+  info "settings.json already exists (skipping)"
+fi
+
+# envrc
+if command -v direnv >/dev/null 2>&1; then
+  if [ ! -f "$HOME/.envrc" ]; then
+    cp "$DEVKIT_DIR/config/envrc/global.envrc" "$HOME/.envrc"
+    info "Installed global .envrc"
+  else
+    info "Global .envrc already exists (skipping)"
+  fi
+else
+  warn "direnv not found. Skipping .envrc setup."
+fi
+
+# ── Codex MCP 등록 (가능하면) ──
+header "7. Codex Integration (optional)"
+
+if command -v codex >/dev/null 2>&1; then
+  codex mcp add deliberation -- node "$MCP_DEST/index.js" 2>/dev/null && \
+    info "Registered deliberation MCP in Codex" || \
+    warn "Codex MCP registration failed (may already exist)"
+
+  if codex mcp list 2>/dev/null | grep -q "deliberation"; then
+    info "Codex MCP verification passed (deliberation found)"
+  else
+    warn "Codex MCP verification failed. Run manually: codex mcp add deliberation -- node $MCP_DEST/index.js"
+  fi
+else
+  warn "Codex CLI not found. Skipping Codex integration."
+fi
+
+header "8. Cross-platform Notes"
+info "Codex is a deliberation participant CLI, not a separate MCP server."
+info "Browser LLM tab detection: macOS automation + CDP scan (Linux/Windows need browser remote-debugging port)."
+info "If browser tab auto-scan is unavailable, use clipboard workflow: prepare_turn -> paste in browser -> submit_turn."
+
+# ── 완료 ──
+header "Installation Complete!"
+echo ""
+echo -e "  ${BOLD}Installed components:${NC}"
+echo -e "    Skills:     $(ls -d "$SKILLS_DEST"/*/ 2>/dev/null | wc -l | tr -d ' ') skills in $SKILLS_DEST"
+echo -e "    HUD:        $HUD_DEST/simple-status.sh"
+echo -e "    MCP Server: $MCP_DEST"
+echo -e "    Config:     $CLAUDE_DIR"
+echo ""
+echo -e "  ${BOLD}Next steps:${NC}"
+echo -e "    1. Restart Claude/Codex processes for MCP changes to take effect"
+echo -e "    2. Add other MCP servers to $MCP_CONFIG as needed"
+echo -e "    3. Configure your HUD in settings.json if not already done"
+echo -e "    4. For Linux/Windows browser scan, launch browser with --remote-debugging-port=9222"
+echo ""
+echo -e "  ${CYAN}Enjoy your AI development environment!${NC}"