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.
- Download and unzipUnzip portware-connector.zip into a folder. It needs Python 3.11 or newer.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- See its statusComputer Status on the device form fills within a minute. On Linux: systemctl --user status portware-connector.
- 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.
Let's discuss your business.
Tell us how your organisation works today, and we will present PORTWARE through your own processes.