Skip to Content

DOWNLOADS

PORTWARE Connector

A small program that starts the work on your own computer when you press Start AI Work on a PORTWARE task. It only calls out, signs every call with a key made on this computer and runs only the commands in the recipes you wrote.

WHAT IT DOES

In your program, on the PORTWARE record.

  • Streams a live AI session to the task's Live Screen; a message you write in PORTWARE goes to the same session.
  • Reports the computer's status (processors, memory, disk, open sessions, version) every minute.
  • Opens no port on the computer; the key never leaves it.
  • The installer keeps an existing pairing and recipes; it starts by itself with the computer.

Before you start

  • Linux (systemd) or Windows 10/11, Python 3.11 or newer
  • Ready: run and checked end to end inside the program itself.
  • Version 1.2.0·16 November 2026·51 KB·portware-connector.zip
  • SHA-256, to check the file you downloaded:
    1440b2ce5b94a8d73c002ece317848f1ad39dc6fa16b273af184291decec129c

INSTALL

Set it up once.

  1. Download and unzipUnzip portware-connector.zip into a folder. It needs Python 3.11 or newer.
  2. Install on LinuxIn a terminal: sh portware-connector/install.sh --server https://YOUR-SERVER --name "My PC" --workdir ~/my-repo. The program goes to ~/.local/share/portware-connector, the service is a systemd user service.
  3. Install on WindowsIn PowerShell: powershell -ExecutionPolicy Bypass -File portware-connector\install.ps1 -Server https://YOUR-SERVER -Name "My PC" -Workdir C:\my-repo. It installs as a task that starts when you sign in.
  4. Pair and check the keyThe script prints a code and a key fingerprint. In PORTWARE › AI-Native Engineering Bridge › Connect This Device, enter the code, check the fingerprint is the same and confirm. The service starts at once.
  5. Turn on what it may doBridge › Devices › this computer: Allow VS Code Extension and, if you need it, Allow Remote Terminal; each asks your password.

USE

Every day.

The add-in signs in as you: it sees only what you may see in PORTWARE, and every save is a new version you can go back to.

  1. RecipesThe installer writes recipes for the programs it finds: Claude Code (Live) and Open in VS Code. The file is ~/.config/portware-connector/recipes.json (Windows: %APPDATA%\PORTWARE Connector); a recipe you have stays as it is.
  2. RunOn a task, Start AI Work: pick this computer and the Claude Code (Live) recipe. The Live Screen opens and your message goes to the same session.
  3. See its statusComputer Status on the device form fills within a minute. On Linux: systemctl --user status portware-connector.
  4. UninstallLinux: sh ~/.local/share/portware-connector/install.sh --uninstall; Windows: install.ps1 -Uninstall. Add --forget (-Forget) to delete the pairing too, and revoke the device in PORTWARE.

All downloads

Let's discuss your business.

Tell us how your organisation works today, and we will present PORTWARE through your own processes.