Skip to content
TruthVouch Docs

Install: macOS

System Requirements

  • OS: macOS 10.15+
  • Architecture: Intel or Apple Silicon (M1/M2/M3)
  • RAM: 256 MB minimum
  • Disk: 500 MB
  • Network: Internet connectivity
  • Admin Rights: Required for installation

Installation via DMG (Easiest)

Step 1: Download

  1. Go to https://app.truthvouch.io/downloads/sentinel/macos
  2. Click Download Sentinel-latest-universal.dmg
  3. Save to Downloads

Step 2: Install

  1. Double-click Sentinel-latest-universal.dmg
  2. Drag Sentinel Agent to Applications folder
  3. Wait for copy to complete
  4. Eject DMG from Finder

Step 3: Launch

  1. Open Applications folder
  2. Double-click Sentinel Agent
  3. Click Open (if security prompt appears)
  4. Sign In:
    • Email: Your work email
    • Password: Your TruthVouch password
  5. Grant permissions (see below)
  6. Click Continue

Installation via Homebrew

For developers/power users:

Terminal window
# Install Homebrew (if not already)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"


# Install Sentinel
brew tap truthvouch/sentinel
brew install sentinel-agent


# Launch
sentinel-agent

Permissions

macOS requires explicit permissions. Grant when prompted:

  1. Full Disk Access: Monitor all apps

    • System Preferences → Security & Privacy
    • Click 🔒 to unlock
    • Add Sentinel to Full Disk Access list

  2. Accessibility: Monitor keyboard/mouse

    • System Preferences → Security & Privacy
    • Add Sentinel to Accessibility

  3. Microphone/Camera: For compliance features (optional)

    • System Preferences → Security & Privacy
    • Grant if needed

These are one-time permissions.

Configuration

First Launch

  1. After sign-in, Sentinel shows config screen
  2. Enable Monitoring:
    • ChatGPT: ✓
    • Claude: ✓
    • Copilot: ✓
  3. Reporting: Enable auto-reporting
  4. Click Complete Setup

System-Wide Settings

Edit config file:

Terminal window
nano ~/.truthvouch/sentinel/config.json

Example:

{
  "monitoring": {
    "monitor_chatgpt": true,
    "monitor_claude": true,
    "monitor_copilot": true
  },
  "reporting": {
    "auto_upload": true,
    "upload_interval_minutes": 60
  },
  "dlp": {
    "enabled": true,
    "block_pii": true
  }
}

Save and restart Sentinel:

Terminal window
killall "Sentinel Agent"
open -a "Sentinel Agent"

Updates

Automatic Updates

Sentinel checks for updates hourly and auto-updates in background.

Manual Update

Terminal window
# Check version
sentinel-agent --version


# Force check for updates
sentinel-agent --check-updates


# Force update
sentinel-agent --update

Sentinel appears in macOS menu bar (top-right):

  • Green dot: Connected, monitoring active
  • Yellow dot: Connecting
  • Red dot: Not connected

Click to see:

  • Status
  • Quick settings
  • View logs
  • Help

Uninstall

If installed via DMG

Terminal window
# Remove from Applications
rm -rf /Applications/Sentinel\ Agent.app


# Remove config
rm -rf ~/.truthvouch

If installed via Homebrew

Terminal window
brew uninstall sentinel-agent
rm -rf ~/.truthvouch

Troubleshooting

”Cannot verify developer” error

System Preferences → Security & Privacy
Click "Open Anyway" next to Sentinel Agent

Agent not monitoring

1. Quit: Cmd+Q
2. Grant Full Disk Access (see Permissions section)
3. Relaunch

High CPU/Memory Usage

1. Check Activity Monitor
2. Right-click Sentinel Agent process → Quit
3. Restart from Applications
4. If still high, disable screenshots:
   Edit ~/.truthvouch/sentinel/config.json
   Set "include_screenshots": false

Auto-Update Failed

Manual update:
1. Download DMG from https://app.truthvouch.io/downloads
2. Run installer again
3. Choose "Reinstall" option

Command Line

Useful commands:

Terminal window
# Check status
sentinel-agent --status


# View logs
tail -f ~/.truthvouch/sentinel/agent.log


# Stop agent
sentinel-agent --stop


# Start agent
sentinel-agent --start


# Restart agent
sentinel-agent --restart

Support