@weavz-io/local-computer-control
v0.1.0
Published
Local computer companion launcher for Weavz Agent Local Computer Control
Maintainers
Readme
Weavz Local Computer Control
Launcher for Weavz Agent Local Computer Control.
This package validates a Weavz local computer session URL and opens the signed Weavz Local Computer Control macOS app. The app owns macOS Screen Recording and Accessibility permissions, shows visible control status, and connects outbound to the Weavz session.
Signed app download metadata will be published in app-manifest.json once the notarized macOS app is
available. Native app source and signing configuration are not part of this public package.
Usage
Start a local computer session from Weavz first. The start_session or ensure_connected action
returns a localRunnerCommand that looks like this:
npx -y @weavz-io/local-computer-control connect --url "<localRunnerUrl from start_session>"Run that command on the Mac that should host the session.
Requirements
- Node.js 22.13+
- macOS with the signed Weavz Local Computer Control app installed
- A Weavz local computer session URL from
agent-local-computer-control
Security
Treat the localRunnerCommand as a short-lived secret. It contains a session-scoped credential and
should only be run by the user on the Mac that should attach to the session.
By default, the CLI only accepts Weavz hosted session URLs and loopback development URLs. For
self-hosted Weavz endpoints, pass --allow-custom-url only when you trust the endpoint. For custom
hosts, the launcher writes a short-lived local grant that the macOS app consumes before connecting;
direct custom-scheme links cannot bypass this check.
npx -y @weavz-io/local-computer-control connect \
--url "<self-hosted localRunnerUrl from start_session>" \
--allow-custom-url