qev-workspace
v0.1.6
Published
Consent-first remote workspace CLI for installing and launching QEV Host.
Maintainers
Readme
QEV Workspace
Consent-first remote workspace tooling for teams.
QEV Workspace is built around one rule:
No silent access. No unattended control. No hidden monitoring.
This npm package is a lightweight installer and launcher for QEV Host, the native desktop app that runs on the computer being controlled.
What this package does
qev-workspace helps users:
- open the QEV Workspace web app
- check their platform
- find the right QEV Host installer
- download and launch the Mac or Windows desktop installer from GitHub Releases
It does not silently install remote-control software. It does not run a hidden agent. It does not bypass OS permissions.
Quick start
npx qev-workspace installOpen the web app:
npx qev-workspace open-webCheck your setup:
npx qev-workspace doctorCommands
qev-workspace installDownload and open the right QEV Host installer for this computer.
qev-workspace doctorCheck Node version, platform, GitHub release availability, and matching installer assets.
qev-workspace statusShow basic local install hints.
qev-workspace open-webOpen the QEV Workspace public web app.
qev-workspace open-releaseOpen the QEV Host GitHub Releases page.
qev-workspace helpShow command help.
Architecture
QEV Workspace has two parts.
Web app
Used for session creation, joining sessions, viewing remote screens, requesting control, and approving or revoking control.
https://theartofsound.github.io/qev-workspace/QEV Host desktop app
Installed on the computer being controlled.
Used for native screen capture, launch-at-login, OS permission checks, visible control approval, and future native input execution.
https://github.com/TheArtOfSound/qev-workspace/releasesSecurity model
QEV Workspace is designed around explicit consent.
- The host app must be installed intentionally.
- The controlled computer must approve control.
- macOS and Windows permissions must be granted explicitly.
- Control is time-limited.
- Control can be revoked.
- The browser is not treated as the controlled computer.
- The native host app is responsible for OS-level behavior.
Platform support
| Platform | Status | |---|---| | macOS | Preview installer workflow | | Windows | Preview installer workflow | | Linux | Not packaged yet |
Example flow
On the computer being controlled:
npx qev-workspace installThen install QEV Host, open it, enable launch at login, grant required OS permissions, and use the QEV Workspace web app for sessions.
On the viewer computer:
npx qev-workspace open-webRepository
https://github.com/TheArtOfSound/qev-workspaceLicense
UNLICENSED preview package.
