PC Bridge
by Martin123132
README.md
# PC Bridge
**Connect AI conversations to Windows workspaces you control.**
PC Bridge is a Windows desktop bridge that lets supported AI clients use locally authorised tools on your own PC. The AI stays in the chat you already use; PC Bridge provides the controlled connection to files, project tasks, commands and local state.
> Early public preview — v0.5.16
## Download
Windows x64 builds are published on the [GitHub Releases page](https://github.com/Martin123132/PC-Bridge/releases).
For most users, download:
- `PC-Bridge-Setup-0.5.16-Windows-x64.exe`
A portable ZIP is also provided:
- `PC-Bridge-0.5.16-Windows-x64.zip`
Verify downloads against `SHA256SUMS.txt` on the release.
**Current preview builds are not yet code-signed**, so Windows SmartScreen may warn when you first run them.
## See it working
[Watch the full ChatGPT setup and first-test video](docs/media/PC-Bridge-Setup-and-First-Test.mp4)
The video walks from opening PC Bridge, through the real ChatGPT setup, to a harmless action on the PC.
## Siri Virtual Phone — source preview
PC Bridge now includes a **Connect Siri** page with a burgundy, phone-shaped workspace. It is part of the **same Windows application**, not a separate desktop app or an iOS emulator.
- A Siri-triggered iPhone Shortcut can send a command to the owner's PC on the private LAN, then speak PC Bridge's actual response.
- The desktop phone interface offers Google search in Microsoft Edge, Apple Music, Files, Notepad, Calculator, Windows status, Codex task records, and recent Bridge activity.
- The integrated iPhone-to-PC connection has been demonstrated, including launching Windows Apple Music. Individual Windows applications must already be installed and functioning.
- The Siri connection starts locally and is controlled by the existing PC Bridge access settings. The same Calendar/Activity history remains available to other connected assistants.
**Source-versus-download status:** the source preview is ahead of the previously published Windows installers. Existing GitHub Releases downloads may not yet contain the Siri phone interface. A refreshed installer will need separate clean-machine acceptance.
See [Siri and Apple Shortcuts setup](docs/SIRI_SHORTCUTS_SETUP.md). This repository does not contain personal pairing keys, owner-specific LAN addresses, or iPhone Shortcut exports.
## What it currently supports
- ChatGPT through the official OpenAI tunnel client.
- Claude through a persistent remote MCP endpoint.
- Per-client authority ceilings.
- Global access modes: Read only, Files only, Project Tasks, Read + approve changes, and Full access.
- Protected file reads/writes.
- Locally approved project tasks and tests.
- Short commands and managed long-running processes.
- Git status/diff helpers.
- Local Vault activity history and source snapshots.
- A persistent ChatGPT web view inside the desktop app.
- An opt-in Siri/Apple Shortcuts connection and virtual phone interface.
- A shared Calendar/Activity record for work performed through supported clients.
PC Bridge runs tools as the signed-in Windows user. **It is not an operating-system sandbox.**
## Windows downloads
Private/public release builds provide:
- `PC-Bridge-Setup-0.5.16-Windows-x64.exe` — normal Windows installer.
- `PC-Bridge-0.5.16-Windows-x64.zip` — portable fallback.
The current preview build is **not code-signed**, so Windows SmartScreen may show an unknown-publisher warning. Verify the release against `SHA256SUMS.txt` before running it.
See [docs/FRESH_MACHINE_TEST.md](docs/FRESH_MACHINE_TEST.md) for the clean-PC acceptance test.
## Quick start
### ChatGPT
Follow [docs/CHATGPT_SETUP.md](docs/CHATGPT_SETUP.md), or use the video above.
At a high level:
1. Open PC Bridge and configure the OpenAI tunnel ID + restricted runtime key.
2. Enable Developer mode in ChatGPT.
3. Create the ChatGPT app/plugin using **Tunnel** rather than **Server URL**.
4. Select your tunnel.
5. Add PC Bridge to a normal chat and call `bridge_status`.
### Claude
Follow [docs/CLAUDE_SETUP.md](docs/CLAUDE_SETUP.md).
PC Bridge creates a persistent HTTPS MCP endpoint for the local installation. Treat the full connector URL like a password: its final path contains a capability secret.
## Run from source
Requirements:
- Windows 10/11
- Node.js
- Git
```powershell
git clone https://github.com/Martin123132/PC-Bridge.git
cd PC-Bridge
npm ci
npm start
```
The repository includes the official OpenAI Windows tunnel client under `vendor/`, with its original licence and notice files.
## Test
```powershell
npm test
npm run verify:release
```
The release verifier checks the expected tunnel-client hash and rejects common credential/state patterns before publication.
## Security model
PC Bridge has two permission layers:
1. a global local access mode; and
2. a per-client maximum authority.
The stricter setting wins.
Use the lowest authority that fits the job. Full access can run arbitrary PowerShell, cmd and Node commands as your Windows user.
See [SECURITY.md](SECURITY.md).
## Privacy
PC Bridge keeps its local policy and activity state on the PC. Do not commit local state files, runtime keys, tunnel IDs or persistent connector URLs.
The Claude connection currently uses the `@maxoperf/tunnel` guest tunnel service to provide a persistent public HTTPS route to the locally authorised MCP endpoint.
## Licence
PC Bridge original code is **source-available under a dual licence**:
- PolyForm Noncommercial 1.0.0; **or**
- PolyForm Small Business 1.0.0,
at the user's option.
That means individuals, noncommercial users and qualifying small businesses can use, modify and redistribute PC Bridge within the applicable licence terms. Uses outside both grants require a separate commercial licence from Two Hands Network Ltd.
This is intentionally **not** presented as OSI-approved open-source software.
See [LICENSE](LICENSE), [COMMERCIAL_LICENSE.md](COMMERCIAL_LICENSE.md) and [TRADEMARKS.md](TRADEMARKS.md).
Third-party software retains its own licences. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) and `vendor/`.
## Company
PC Bridge is developed by **Two Hands Network Ltd**.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues