Add thv install script

Signed-off-by: Dan Barr <[email protected]>

Author: danbarr

.devcontainer/devcontainer.json

@@ -1,9 +1,14 @@
 {
   "name": "Docusaurus",
   "image": "mcr.microsoft.com/devcontainers/typescript-node:22-bookworm",
-  "features": {},
+  "features": {
+    "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {}
+  },
   "forwardPorts": [3000],
-  "postCreateCommand": "npm install",
+  "containerEnv": {
+    "CI": "true"
+  },
+  "postStartCommand": "bash scripts/install-thv.sh && npm install",
   "customizations": {
     "vscode": {
       "extensions": [

scripts/install-thv.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# SPDX-FileCopyrightText: Copyright 2025 Stacklok, Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+# This script installs the ToolHive CLI (thv) in a portable way that works
+# across different environments (dev containers, CI/CD, Vercel, etc.).
+
+set -euo pipefail
+
+# Check if jq is installed
+if ! command -v jq >/dev/null 2>&1; then
+    echo "Error: 'jq' is required but not installed. Please install jq and try again."
+    exit 1
+fi
+
+API_ENDPOINT="https://api.github.com/repos/stacklok/toolhive/releases/latest"
+
+# Fetch release information
+RELEASE_JSON=$(curl -sf "$API_ENDPOINT" || {
+    echo "Failed to fetch release information from GitHub API"
+    exit 1
+})
+RELEASE_VERSION=$(echo "$RELEASE_JSON" | jq -r '.tag_name // empty' | sed 's/^v//')
+RELEASE_TARBALL=$(echo "$RELEASE_JSON" | jq -r \
+    --arg version "$RELEASE_VERSION" \
+    '.assets[] | select(.name == "toolhive_" + $version + "_linux_amd64.tar.gz") | .browser_download_url // empty')
+
+if [ -z "$RELEASE_TARBALL" ]; then
+    echo "Failed to get release tarball URL for release: ${RELEASE_VERSION}"
+    echo "Please check if the tag exists in the repository"
+    exit 1
+fi
+
+# Determine installation location based on write permissions
+if [[ -w "/usr/local/bin" ]]; then
+    # Can write to /usr/local/bin (e.g., CI/CD environments like Vercel)
+    INSTALL_DIR="/usr/local/bin"
+    echo "Installing to /usr/local/bin"
+else
+    # Use user-local directory (e.g., dev containers)
+    INSTALL_DIR="$HOME/.local/bin"
+    echo "Installing to ~/.local/bin"
+    
+    # Create user bin directory if it doesn't exist
+    mkdir -p "$INSTALL_DIR"
+    
+    # Automatically add ~/.local/bin to PATH in shell profile files
+    for profile in ~/.bashrc ~/.zshrc ~/.profile; do
+        if [[ -f "$profile" ]]; then
+            # Check if the PATH export already exists to avoid duplicates
+            if ! grep -q 'export PATH="$HOME/.local/bin:$PATH"' "$profile" 2>/dev/null; then
+                echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$profile"
+                echo "Added ~/.local/bin to PATH in $profile"
+            fi
+        fi
+    done
+    
+    # Also set PATH for current session
+    export PATH="$HOME/.local/bin:$PATH"
+fi
+
+# Download the release tarball and extract the binary
+echo "Downloading ToolHive CLI release $RELEASE_VERSION"
+curl -s -L "$RELEASE_TARBALL" -o /tmp/toolhive.tar.gz
+tar -xzf /tmp/toolhive.tar.gz -C /tmp thv
+chmod +x /tmp/thv
+cp /tmp/thv "$INSTALL_DIR/thv"
+rm -f /tmp/toolhive.tar.gz /tmp/thv
+
+echo "ToolHive CLI (thv) installed successfully. Version: $RELEASE_VERSION"
+echo "The 'thv' command is now available in your PATH."

vercel.json

@@ -1,4 +1,5 @@
 {
+  "$schema": "https://openapi.vercel.sh/vercel.json",
   "redirects": [
     {
       "source": "/toolhive/quickstart",
@@ -10,5 +11,7 @@
       "destination": "/toolhive/tutorials/quickstart-k8s",
       "permanent": true
     }
-  ]
+  ],
+  "installCommand": "dnf install -q -y jq && npm install",
+  "buildCommand": "./scripts/install-thv.sh && npm run build"
 }