Desktop app that records your on-screen work session and uses the GitHub Copilot SDK to reconstruct it as an intent + ordered steps, then builds a reusable Skill or Automation for Microsoft Autopilots like Scout, Microsoft Copilot Cowork, or Copilot Studio.
TypeScript agent-skillsai-agentsautomationcopilotcopilot-clicopilot-coworkcopilot-studioelectronmicrosoft-scoutscreen-recording
Add curl/irm one-line install-and-run scripts
adilei2d4fe37e2740
diff --git a/README.md b/README.mdindex e3f6e71..cb7b2e9 100644--- a/README.md+++ b/README.md@@ -76,9 +76,44 @@ On first launch macOS will prompt for **Screen Recording** (required). EnablingNarrate requests **Microphone** permission immediately so named inputs can be selectedbefore recording; the permission-check stream is released without saving audio.+## Quick start (download & run)++Don't want to clone and manage a source checkout? A one-line installer downloads Skill+Recorder into `~/.skill-recorder`, installs its dependencies, builds it, and launches+it. It's **safe to re-run**: the same command updates an existing install to the latest+code and only reinstalls or rebuilds when something actually changed.++**macOS / Linux:**++```bash+curl -fsSL https://raw.githubusercontent.com/adilei/skill-recorder/master/install.sh | bash+```++**Windows (PowerShell):**++```powershell+irm https://raw.githubusercontent.com/adilei/skill-recorder/master/install.ps1 | iex+```++You still need **Node.js 22+** and, for analysis, the **GitHub Copilot CLI** (see+[Requirements](#requirements)). The installer prefers `git` and falls back to a source+tarball/zip download when `git` isn't available.++Prefix either command with these optional overrides to change its behavior:++| Variable | Default | Purpose |+| --- | --- | --- |+| `SKILL_RECORDER_HOME` | `~/.skill-recorder` | where the app is installed |+| `SKILL_RECORDER_REF` | `master` | branch, tag, or commit to install |+| `SKILL_RECORDER_NO_RUN` | *(unset)* | install & build only, don't launch |++To update and relaunch later, just run the same one-liner again; to launch without+re-downloading, run `npm start` from the install directory.+## Run it (development)-> There is no packaged/released download yet — run it from source.+> Prefer the one-line installer above for a quick run. To hack on the code, run it from+> source instead:```bashnpm installdiff --git a/install.ps1 b/install.ps1new file mode 100644index 0000000..ef5ab2e--- /dev/null+++ b/install.ps1@@ -0,0 +1,125 @@+<#+ Skill Recorder — download & run (Windows).++ Fetches Skill Recorder from source into a local directory, installs its+ dependencies, builds it, and launches it. A lightweight alternative to+ packaged installers (no .exe / .msi): it just runs the app from source.++ The script is idempotent — re-running it fast-forwards to the latest code and+ skips any step (dependency install, build) whose inputs haven't changed, so+ the same one-liner both installs and updates the app.++ Usage (PowerShell):+ irm https://raw.githubusercontent.com/adilei/skill-recorder/master/install.ps1 | iex++ Or with curl.exe:+ curl.exe -fsSL https://raw.githubusercontent.com/adilei/skill-recorder/master/install.ps1 -o "$env:TEMP\install.ps1"; & "$env:TEMP\install.ps1"++ Environment overrides:+ SKILL_RECORDER_HOME install directory (default: %USERPROFILE%\.skill-recorder)+ SKILL_RECORDER_REPO owner/repo (default: adilei/skill-recorder)+ SKILL_RECORDER_REF branch / tag / commit (default: master)+ SKILL_RECORDER_NO_RUN set to install & build only, without launching+#>++$ErrorActionPreference = 'Stop'++$Repo = if ($env:SKILL_RECORDER_REPO) { $env:SKILL_RECORDER_REPO } else { 'adilei/skill-recorder' }+$Ref = if ($env:SKILL_RECORDER_REF) { $env:SKILL_RECORDER_REF } else { 'master' }+$InstallDir = if ($env:SKILL_RECORDER_HOME) { $env:SKILL_RECORDER_HOME } else { Join-Path $env:USERPROFILE '.skill-recorder' }++function Info($m) { Write-Host "==> $m" -ForegroundColor Cyan }+function Have($c) { [bool](Get-Command $c -ErrorAction SilentlyContinue) }++# Abort if the most recent native command reported a non-zero exit code+# (PowerShell does not treat native exit codes as terminating errors on its own).+function Assert-Ok($what) {+ if ($LASTEXITCODE -ne 0) { throw "$what failed (exit $LASTEXITCODE)" }+}++function FileSha($path) {+ if (Test-Path -LiteralPath $path) { (Get-FileHash -LiteralPath $path -Algorithm SHA256).Hash } else { '' }+}++# --- prerequisites ---------------------------------------------------------+if (-not (Have 'node')) { throw "Node.js 22+ is required but 'node' was not found on PATH." }+if (-not (Have 'npm')) { throw "npm is required but was not found on PATH." }++$nodeMajor = [int](& node -p 'process.versions.node.split(".")[0]')+if ($nodeMajor -lt 22) { throw "Node.js 22+ is required (found $(& node -v))." }++if (-not (Have 'copilot')) {+ Write-Warning "GitHub Copilot CLI ('copilot') not found on PATH. The app will launch, but recording analysis and skill/automation building need it — install it and sign in first."+}++# --- fetch source ----------------------------------------------------------+$versionToken = ''+if (Have 'git') {+ if (-not (Test-Path -LiteralPath (Join-Path $InstallDir '.git'))) {+ if (Test-Path -LiteralPath $InstallDir) { Remove-Item -Recurse -Force -LiteralPath $InstallDir }+ New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null+ & git -C $InstallDir init -q; Assert-Ok 'git init'+ & git -C $InstallDir remote add origin "https://github.com/$Repo.git"; Assert-Ok 'git remote add'+ } else {+ & git -C $InstallDir remote set-url origin "https://github.com/$Repo.git"; Assert-Ok 'git remote set-url'+ }+ Info "Fetching $Repo ($Ref) into $InstallDir"+ & git -C $InstallDir fetch --depth 1 origin $Ref; Assert-Ok 'git fetch'+ & git -C $InstallDir reset --hard FETCH_HEAD; Assert-Ok 'git reset'+ $versionToken = (& git -C $InstallDir rev-parse HEAD).Trim(); Assert-Ok 'git rev-parse'+} else {+ Write-Warning "'git' not found — downloading a source zip instead."+ New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null+ $zip = Join-Path $env:TEMP ("skill-recorder-" + [guid]::NewGuid().ToString() + ".zip")+ $tmp = Join-Path $env:TEMP ("skill-recorder-" + [guid]::NewGuid().ToString())+ try {+ Info "Downloading $Repo ($Ref) into $InstallDir"+ Invoke-WebRequest -UseBasicParsing -Uri "https://codeload.github.com/$Repo/zip/$Ref" -OutFile $zip+ Expand-Archive -LiteralPath $zip -DestinationPath $tmp -Force+ $inner = Get-ChildItem -Directory -LiteralPath $tmp | Select-Object -First 1+ # Copy the source over the install dir; node_modules and dist/ are local-only+ # (not in the zip) and are excluded so they survive re-runs.+ robocopy $inner.FullName $InstallDir /E /XD node_modules dist dist-electron /NFL /NDL /NJH /NJS /NP | Out-Null+ if ($LASTEXITCODE -ge 8) { throw "robocopy failed (exit $LASTEXITCODE)" }+ $versionToken = (Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash+ } finally {+ Remove-Item -Recurse -Force -ErrorAction SilentlyContinue -LiteralPath $zip, $tmp+ }+}++Set-Location -LiteralPath $InstallDir++# --- install dependencies (only when the lockfile changed) -----------------+$depsStamp = Join-Path $InstallDir '.skill-recorder-deps.sha'+$depsNow = FileSha 'package-lock.json'+if (-not (Test-Path 'node_modules') -or ((Get-Content -LiteralPath $depsStamp -ErrorAction SilentlyContinue) -ne $depsNow)) {+ Info "Installing dependencies (npm install)…"+ & npm install --no-audit --no-fund; Assert-Ok 'npm install'+ Set-Content -LiteralPath $depsStamp -Value $depsNow+} else {+ Info "Dependencies already up to date — skipping npm install."+}++# --- build (only when the source or dependencies changed) ------------------+$buildStamp = Join-Path $InstallDir '.skill-recorder-build.sha'+$buildNow = "${versionToken}:${depsNow}"+if (-not (Test-Path 'dist-electron/main.js') -or -not (Test-Path 'dist/index.html') -or+ ((Get-Content -LiteralPath $buildStamp -ErrorAction SilentlyContinue) -ne $buildNow)) {+ Info "Building app (npm run build)…"+ & npm run build; Assert-Ok 'npm run build'+ Set-Content -LiteralPath $buildStamp -Value $buildNow+} else {+ Info "Build already up to date — skipping npm run build."+}++Info "Skill Recorder is installed in $InstallDir"+Info "Re-run the same command any time to update & launch, or: cd `"$InstallDir`"; npm start"++# --- launch ----------------------------------------------------------------+if ($env:SKILL_RECORDER_NO_RUN) {+ Info "SKILL_RECORDER_NO_RUN set — not launching."+ return+}++Info "Launching Skill Recorder…"+& npm start; Assert-Ok 'npm start'diff --git a/install.sh b/install.shnew file mode 100755index 0000000..a6ea58b--- /dev/null+++ b/install.sh@@ -0,0 +1,117 @@+#!/usr/bin/env bash+#+# Skill Recorder — download & run (macOS / Linux).+#+# Fetches Skill Recorder from source into a local directory, installs its+# dependencies, builds it, and launches it. This is a lightweight alternative+# to packaged installers (no .dmg / .exe): it just runs the app from source.+#+# The script is idempotent — re-running it fast-forwards to the latest code and+# skips any step (dependency install, build) whose inputs haven't changed, so+# the same one-liner both installs and updates the app.+#+# Usage:+# curl -fsSL https://raw.githubusercontent.com/adilei/skill-recorder/master/install.sh | bash+#+# Environment overrides:+# SKILL_RECORDER_HOME install directory (default: ~/.skill-recorder)+# SKILL_RECORDER_REPO owner/repo (default: adilei/skill-recorder)+# SKILL_RECORDER_REF branch / tag / commit (default: master)+# SKILL_RECORDER_NO_RUN set to install & build only, without launching+#+set -euo pipefail++REPO="${SKILL_RECORDER_REPO:-adilei/skill-recorder}"+REF="${SKILL_RECORDER_REF:-master}"+INSTALL_DIR="${SKILL_RECORDER_HOME:-$HOME/.skill-recorder}"++info() { printf '\033[1;34m==>\033[0m %s\n' "$*"; }+warn() { printf '\033[1;33mwarning:\033[0m %s\n' "$*" >&2; }+die() { printf '\033[1;31merror:\033[0m %s\n' "$*" >&2; exit 1; }+have() { command -v "$1" >/dev/null 2>&1; }++sha256() { # print the sha256 of a file, or nothing if it doesn't exist+ [ -f "$1" ] || return 0+ if have shasum; then shasum -a 256 "$1" | awk '{print $1}'+ else sha256sum "$1" | awk '{print $1}'; fi+}++# --- prerequisites ---------------------------------------------------------+have node || die "Node.js 22+ is required but 'node' was not found on PATH."+have npm || die "npm is required but was not found on PATH."++node_major="$(node -p 'process.versions.node.split(".")[0]' 2>/dev/null || echo 0)"+[ "${node_major:-0}" -ge 22 ] || die "Node.js 22+ is required (found $(node -v))."++have copilot || warn "GitHub Copilot CLI ('copilot') not found on PATH. The app will \+launch, but recording analysis and skill/automation building need it — install it and \+sign in first."++# --- fetch source ----------------------------------------------------------+version_token=""+if have git; then+ if [ ! -d "$INSTALL_DIR/.git" ]; then+ rm -rf "$INSTALL_DIR"+ mkdir -p "$INSTALL_DIR"+ git -C "$INSTALL_DIR" init -q+ git -C "$INSTALL_DIR" remote add origin "https://github.com/$REPO.git"+ else+ git -C "$INSTALL_DIR" remote set-url origin "https://github.com/$REPO.git"+ fi+ info "Fetching $REPO ($REF) into $INSTALL_DIR"+ git -C "$INSTALL_DIR" fetch --depth 1 origin "$REF"+ git -C "$INSTALL_DIR" reset --hard FETCH_HEAD+ version_token="$(git -C "$INSTALL_DIR" rev-parse HEAD)"+else+ warn "'git' not found — downloading a source tarball instead."+ have curl || die "Either 'git' or 'curl' is required to download Skill Recorder."+ have tar || die "'tar' is required to extract the source tarball."+ mkdir -p "$INSTALL_DIR"+ tarball="$(mktemp -t skill-recorder.XXXXXX)"+ trap 'rm -f "$tarball"' EXIT+ info "Downloading $REPO ($REF) into $INSTALL_DIR"+ curl -fsSL "https://codeload.github.com/$REPO/tar.gz/$REF" -o "$tarball"+ # --strip-components=1 drops the top "repo-ref/" directory; node_modules and+ # dist/ live only locally (they're not in the tarball) so they survive.+ tar -xzf "$tarball" --strip-components=1 -C "$INSTALL_DIR"+ version_token="$(sha256 "$tarball")"+ rm -f "$tarball"+ trap - EXIT+fi++cd "$INSTALL_DIR"++# --- install dependencies (only when the lockfile changed) -----------------+deps_stamp="$INSTALL_DIR/.skill-recorder-deps.sha"+deps_now="$(sha256 package-lock.json)"+if [ ! -d node_modules ] || [ "$(cat "$deps_stamp" 2>/dev/null || true)" != "$deps_now" ]; then+ info "Installing dependencies (npm install)…"+ npm install --no-audit --no-fund+ printf '%s\n' "$deps_now" > "$deps_stamp"+else+ info "Dependencies already up to date — skipping npm install."+fi++# --- build (only when the source or dependencies changed) ------------------+build_stamp="$INSTALL_DIR/.skill-recorder-build.sha"+build_now="${version_token}:${deps_now}"+if [ ! -f dist-electron/main.js ] || [ ! -f dist/index.html ] \+ || [ "$(cat "$build_stamp" 2>/dev/null || true)" != "$build_now" ]; then+ info "Building app (npm run build)…"+ npm run build+ printf '%s\n' "$build_now" > "$build_stamp"+else+ info "Build already up to date — skipping npm run build."+fi++info "Skill Recorder is installed in $INSTALL_DIR"+info "Re-run the same command any time to update & launch, or: (cd \"$INSTALL_DIR\" && npm start)"++# --- launch ----------------------------------------------------------------+if [ -n "${SKILL_RECORDER_NO_RUN:-}" ]; then+ info "SKILL_RECORDER_NO_RUN set — not launching."+ exit 0+fi++info "Launching Skill Recorder…"+exec npm start