Usage guide · Part of the KPI system that is pending director + HR/legal sign-off before team-wide rollout
Mac Monitoring Agent
Techies KPI — Mac Agent
A small, disclosed menu-bar app that records metadata only — app-category time and
your own (redacted) Claude Code prompts — to support the AI-adoption signal. It never reads your
screen, files, or Claude's responses. Install once; it keeps itself up to date automatically.
↓Download & install
Current version v0.3.0 · signed & notarized by Apple ·
Apple Silicon & Intel.
macOS 13 (Ventura) or later. This link always serves the latest build.
Set it up (about a minute)
Double-click the downloaded .zip in Finder to unzip it. Use Finder —
not a third-party unzip tool — so the app stays intact.
Drag TechiesKPIAgent.app into your /Applications folder.
Right-click (or Control-click) the app → Open, then click Open in the
dialog. Do this the first time instead of double-clicking — see the note below.
A small Techies icon appears in your menu bar. Read the monitoring disclosure, enter
your email (any address), and click Send verification code.
Enter the 6-digit code emailed to you, then click Verify & enable.
Done — the panel shows Active. That's the only setup you'll ever do.
First open: why right-click → Open? The app is signed and notarized by
Apple, but for any app downloaded from the web macOS still asks you to confirm the first launch.
Right-click → Open gives you an Open button; plain double-clicking can instead
show a “Apple could not verify… is free of malware” warning with no Open button. If you do hit
that, just close it and go to System Settings → Privacy & Security, scroll down, and
click Open Anyway. (Still blocked? Re-download above and unzip with Finder — a third-party
unzip tool can break the app’s signature.)
Updates are automatic. After this first install, new versions
download and install themselves silently in the background — no re-downloading from this page, no more
Gatekeeper prompts, and your sign-in carries over. You won't be asked to enroll again.
1What it captures — and what it never does
Monitoring is disclosed, proportionate, and metadata-level. You can pause or uninstall
it at any time from the menu-bar panel.
Captured (metadata)
Never collected
App-category time — app name only (e.g. IDE, browser, terminal), no window titles
Screen content & screenshots
Your own Claude Code prompts, redacted (secrets/emails stripped)
Keystrokes
Idle time and disclosed pauses
Claude's responses & your file contents
Telemetry is metadata, not transcripts. Nothing is read from other apps' windows, and the
agent never uses the Claude API.
2How sign-in works
Each machine enrolls once with a one-time email code (OTP) — no passwords, no shared keys.
The app emails you a 6-digit code; entering it links this device to your account.
Uploads are authenticated per-device and your identity is verified server-side — you can only ever
submit your own data.
Your sign-in is stored locally with owner-only permissions and survives app updates.
Stop anytime: the menu-bar panel has Pause… and Stop collecting & uninstall.
3Changelog
Version
Date
Changes
v0.3.0
2026-06-05
Per-device email sign-in (OTP) for any address; no shared secret in the app. Seamless silent
auto-updates go live.
v0.2.0
2026-06-05
"Prompts captured today" now resets at local midnight (it previously spanned multiple days).
Auto-update framework added.
v0.1.0
2026-06-04
Initial release — disclosed, metadata-only capture with daily sync.