Skip to content

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.

Add curl/irm one-line install-and-run scripts

adilei2d4fe37e2740
diff --git a/README.md b/README.md
index e3f6e71..cb7b2e9 100644
--- a/README.md
+++ b/README.md
@@ -76,9 +76,44 @@ On first launch macOS will prompt for **Screen Recording** (required). Enabling
Narrate requests **Microphone** permission immediately so named inputs can be selected
before 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:
```bash
npm install
diff --git a/install.ps1 b/install.ps1
new file mode 100644
index 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.sh
new file mode 100755
index 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