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

Sentinel is currently deployed via enterprise onboarding. Contact your account team for installation packages.

Step 2: Install

Once you have received the installation package from your account team, follow the standard installation procedure. Your account team will provide detailed instructions specific to your deployment environment.

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. Contact your account team for the latest installation package
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