Install

workiq-proxy lets your AI assistant search your Microsoft 365 emails, documents, chats, meetings, and people. Pick any installation method below — you’ll be up and running in under a minute.

Before you start

workiq-proxy extends Microsoft Work IQ. You’ll need:

• Node.js 18+ — the underlying Work IQ CLI runs on Node (the installer handles this for you)
• Microsoft 365 Copilot license — your tenant must have M365 Copilot enabled
• Admin-consented permissions — a tenant admin must grant delegated permissions once (see Admin Consent)

Quick install (recommended)

macOS / Linux

curl -fsSL https://stuffbucket.github.io/workiq-proxy/install.sh | sh

The installer:

1. Detects (or installs) Node.js 18+
2. Installs @stuffbucket/workiq-proxy globally via npm
3. Detects any existing @microsoft/workiq installation

To review the script before running it:

curl -fsSL https://stuffbucket.github.io/workiq-proxy/install.sh | less

Windows (PowerShell)

irm https://stuffbucket.github.io/workiq-proxy/install.ps1 | iex

The installer:

1. Detects (or installs) Node.js 18+ via winget, Chocolatey, or Scoop
2. Installs @stuffbucket/workiq-proxy globally via npm
3. Detects any existing @microsoft/workiq installation

To review the script before running it:

irm https://stuffbucket.github.io/workiq-proxy/install.ps1 | more

npm

npm install -g @stuffbucket/workiq-proxy

This installs the workiq-proxy command globally. The npm package downloads the correct platform binary automatically.

npx (no install)

Every configuration example in this documentation uses npx, so you never need a global install:

npx -y @stuffbucket/workiq-proxy

Binary download

Download a prebuilt binary from GitHub Releases and place it somewhere in your PATH.

Platform	Binary
macOS (Apple Silicon)	workiq-proxy-darwin-arm64
macOS (Intel)	workiq-proxy-darwin-x64
Linux (x64)	workiq-proxy-linux-x64
Linux (ARM64)	workiq-proxy-linux-arm64
Windows (x64)	workiq-proxy-win-x64.exe
Windows (ARM64)	workiq-proxy-win-arm64.exe