Skip to content

Install Toolcaise Connect

Connect a computer, choose supported tools, and send monitoring metadata to your workspace. A background connector keeps working when you close its tray menu.

Version 0.4.0-preview.2 · Preview · published

This preview is for technical evaluation. Its programs and installer scripts are not code-signed, and the macOS app is not notarized.

Updates are manual. When this page offers a newer version, toolcaise-connect status and the tray menu say so; nothing is downloaded or installed automatically. toolcaise-connect update-check disable turns that check off.

Each package's SHA-256 is shown below and listed in SHA256SUMS. Command reference →

Before you run an unsigned preview

Your operating system will warn you. First check that the SHA-256 of the file you downloaded matches this page: a match shows it is the file that was published, though not, as a signature would, who published it.

  • Windows: SmartScreen may say “Windows protected your PC”. Choose More info, then Run anyway. Smart App Control, and computers whose administrators allow only signed software, block unsigned programs with no way past: wait for a signed release rather than turning those protections off. If PowerShell only runs signed scripts on your computer (the AllSigned execution policy), the installer script will not run.
  • macOS: Gatekeeper refuses to open the installer and then the app the first time (“Apple could not verify…”). Open System Settings › Privacy & Security and choose Open Anyway for the blocked item. This needs an administrator password and may not be allowed on a managed Mac. Do not turn Gatekeeper off or remove the quarantine attribute.
  • Linux: nothing is signed, so the SHA-256 is the check.

Windows

Intel / AMD 64-bit

  1. Extract the whole ZIP: right-click it and choose Extract All.
  2. Right-click install-windows.ps1 and choose Run with PowerShell. It installs for your Windows user only, without administrator rights, and adds Toolcaise Connect to the Start menu.
  3. Open Toolcaise Connect from Start. From its tray menu, sign in, choose the agents to monitor, then install the background collector.
Download preview ↓

Toolcaise-Connect-0.4.0-preview.2-windows-amd64.zip · 7.5 MB

SHA-256

224efeb99fa87fcdc298e845a77c38f6f07df1426aa052ed66d69e658faf9c78

Check it with Get-FileHash .\Toolcaise-Connect-0.4.0-preview.2-windows-amd64.zip -Algorithm SHA256 (letter case does not matter).

macOS

Apple silicon

  1. Open the ZIP, then open install-macos.command. It copies Toolcaise Connect to the Applications folder in your home folder and keeps the previous version when you upgrade.
  2. Toolcaise Connect runs in the menu bar. Sign in, choose the agents to monitor, then install the background collector.
Download preview ↓

Toolcaise-Connect-0.4.0-preview.2-macos-arm64.zip · 6.9 MB

SHA-256

25918e3a4d168d5ec47b1338a521085cafaeb5f83a38e906d457fbf56dbfedc0

Check it with shasum -a 256 Toolcaise-Connect-0.4.0-preview.2-macos-arm64.zip.

macOS

Intel

  1. Open the ZIP, then open install-macos.command. It copies Toolcaise Connect to the Applications folder in your home folder and keeps the previous version when you upgrade.
  2. Toolcaise Connect runs in the menu bar. Sign in, choose the agents to monitor, then install the background collector.
Download preview ↓

Toolcaise-Connect-0.4.0-preview.2-macos-amd64.zip · 7.4 MB

SHA-256

a4f67b3b9f4d9d46513515e8286a3aa52ebd01543c3ce28784fab17315ec4661

Check it with shasum -a 256 Toolcaise-Connect-0.4.0-preview.2-macos-amd64.zip.

Linux

Intel / AMD 64-bit

  1. Extract the archive and run sh install-linux.sh. It installs the headless connector to ~/.local/bin without root access.
  2. Run toolcaise-connect pair and approve the device in a browser on any computer.
  3. Enable an agent with toolcaise-connect adapters enable claude (or codex), then run toolcaise-connect service install for the background collector.
Download preview ↓

toolcaise-connect-0.4.0-preview.2-linux-amd64.tar.gz · 5.4 MB

SHA-256

409100f609297e3602b86398c9e21bf6c98342f8a40a35aee013167a63b3c1fa

Check it with sha256sum toolcaise-connect-0.4.0-preview.2-linux-amd64.tar.gz.

Linux

ARM64 / Raspberry Pi 64-bit

  1. Extract the archive and run sh install-linux.sh. It installs the headless connector to ~/.local/bin without root access.
  2. Run toolcaise-connect pair and approve the device in a browser on any computer.
  3. Enable an agent with toolcaise-connect adapters enable claude (or codex), then run toolcaise-connect service install for the background collector.
Download preview ↓

toolcaise-connect-0.4.0-preview.2-linux-arm64.tar.gz · 4.9 MB

SHA-256

462573007ec37f5d8f89980164dc24f267b6ab2c7d8df21f62e4d24586836f52

Check it with sha256sum toolcaise-connect-0.4.0-preview.2-linux-arm64.tar.gz.

From install to a verified connection

  1. 01

    Sign in

    Use the tray app or pairing command. Your browser shows the device name and asks which workspace should receive its reports.

  2. 02

    Select tools

    Choose recognized integrations. Detection alone does not enable collection or prove that a tool is monitored.

  3. 03

    Check coverage

    Run a small task in the connected tool, then check its activity in Toolcaise. Missing usage stays unknown.

Choose the connection that fits

Your environmentConnectionCoverage
Desktop agent toolsTray app + supported adapterTelemetry the selected tool exposes; capabilities vary by version.
Server or Raspberry PiHeadless connectorBackground delivery, connection health and selected integrations.
Agents already on the computerFound by the connector on its ownPython, Node, PowerShell and shell scripts that use a model, running or scheduled. Monitoring one records each run's start, end and duration, and on Windows its exit code.
Custom scriptCommand wrapper or Python / Node SDKWrapper: exit and runtime. SDK: instrumented usage, checks and controls.
Cloud-hosted workflowDirect HTTPS integrationEvents explicitly sent by your workflow; a desktop installation cannot discover remote agents.

A connection test confirms delivery. Semantic correctness, token cost and safe pause support require evidence from the relevant integration. This connector does not grant a remote shell.

Read the SDK and direct HTTP setup guide →

Release notes · Command reference · Keep the previous package when updating so you can restore it if needed.