Workforce · V4 §3

Kbot Tracker

Records work activity into your Kbot branch — screenshots, idle time. Two ways to install: browser tracker (works today, no install) or desktop app (coming soon, native background mode).

🌐 Option 1 — Browser tracker (live today)
Member opens /workforce-tracker.html?sub=<sub>&member=<member> in any modern browser (Chrome, Edge, Firefox, Safari 14+). One click on "Share screen" grants permission. Captures + uploads a 640×400 JPG every 10 minutes while the tab stays open. Pauses automatically after 5 min idle. Stop button + capture preview + countdown built in.

Admin: generate the per-member URL from the Workforce panel in the dashboard (see "Get tracker link" next to each member). The URL contains the IDs only — no secrets.

Limits vs the native app: must keep the browser tab open (tracker stops if the tab is closed), can't see active app / window title (browser sandbox blocks this), and the browser shows a small "sharing" pill while the screen-share is live.

💻 Option 2 — Desktop app (pre-release)
Native Electron build for macOS / Windows / Linux. True background — runs from the system tray, sees active app + window title, no tab to keep open. Source is published once Apple Developer ID + Windows EV code-signing are procured. Until then the browser tracker covers ~85% of the use case.
Both options work today. The Electron source is in the repo at apps/kbot-tracker/ — admin clones, runs npm install + npm run build:<os>, distributes the binary. Code-signing certs are still pending so users see "unknown developer" warnings on first launch; right-click → Open on macOS bypasses it.

What it captures

Every ~10 minutes, the tracker posts: While idle (no input for 5+ min), no screenshot is taken — only a "still here, but parked" beat. Members can pause anytime from the tray icon.

Admin: build & distribute

git clone https://github.com/stevehkaser/Kbot.git
cd Kbot/apps/kbot-tracker
npm install

# Build for your team's OS:
npm run build:mac     # → dist/Kbot Tracker-0.1.0.dmg
npm run build:win     # → dist/Kbot Tracker Setup 0.1.0.exe
npm run build:linux   # → dist/Kbot Tracker-0.1.0.AppImage
Upload the resulting installer to a shared location your team can access (Google Drive, internal share, etc.).

Note: builds aren't code-signed yet — members will see "unknown developer" warnings. To bypass: macOS users right-click → Open; Windows users click "More info → Run anyway" on the SmartScreen prompt.

Member: install & sign in

  1. Run the installer your admin sent you.
  2. Look for the Kbot Tracker icon in your menu bar (macOS) or system tray (Windows).
  3. Click → Sign in to Kbot.
  4. Enter your branch slug (in the welcome email — the part after kasercorp.com/Kbot.), your dashboard email + password, and a name for this device.
  5. Done. The tracker quietly heartbeats while you work.

macOS Screen Recording permission

First time the tracker tries to capture a screenshot, macOS will prompt for Screen Recording permission. After granting: 
System Settings → Privacy & Security → Screen Recording → ✓ Kbot Tracker
quit and relaunch the tracker. Heartbeats will start including thumbnails on the next cycle.

Privacy

The tracker does not capture keystrokes or clipboard contents. The active-window title is the most fine-grained data captured. Full-resolution screenshots are only uploaded to your subscriber's Google Drive when you explicitly opt in (toggle in a future settings UI; default is thumbnail-only).

Admins can revoke any device from the dashboard: Workforce → Screenshots → Registered devices → Revoke.

Source: apps/kbot-tracker/ · Server endpoints: /api/workforce/tracker/* · Spec: V4 §3