Status Bar App
InsightAgent Copilot is a lightweight macOS menu bar app that captures audio from your computer and streams it to InsightAgent for real-time transcription during Live Copilot sessions.
How It Works
The app sits in your macOS menu bar as a headphones icon
When you click Start Copilot in the web app, the status bar app receives the session automatically
You select an audio input device and click Start Streaming
Audio is captured and streamed over WebSocket to InsightAgent for real-time transcription
When you click Stop Copilot in the web app (or Stop in the status bar app), the session ends
System Requirements
macOS 14.0 (Sonoma) or later
Apple Silicon (M1/M2/M3/M4) or Intel Mac
Microphone access permission
Internet connection
InsightAgent account
Installation
Download
Download the latest version from your InsightAgent account or request it from your administrator.
Install
Open the downloaded
.appfileDrag InsightAgent Copilot to your Applications folder
Launch the app — a headphones icon appears in your menu bar
On first launch, macOS may show a security prompt. Click Open to proceed.
Grant Microphone Permission
The app needs microphone access to capture audio:
Open System Settings → Privacy & Security → Microphone
Enable InsightAgent Copilot
Signing In
Click the headphones icon in the menu bar
Enter your InsightAgent email and password
Click Sign In
Your credentials are stored securely in the macOS Keychain. You stay signed in across app restarts.
Using the App
Session States
Idle
No active session — waiting for you to start copilot from the web app
Waiting
Polling for a pending copilot session
Ready
A pending session was found — select your audio device and start streaming
Streaming
Audio is being captured and sent to InsightAgent (timer shows elapsed time)
Done
Session completed successfully
Starting a Session
In the web app, navigate to an interview and click Start Copilot
The status bar app detects the pending session automatically (polls every 3 seconds)
Select your preferred audio input device from the dropdown
Click Start Streaming
The audio level meter shows that audio is being captured
Stopping a Session
Either:
Click Stop in the status bar app, or
Click Stop Copilot in the web app
Both methods end the session and save the transcript.
Opening the Interview
Click the Open in Browser link in the status bar app to jump directly to the interview in the web app.
Audio Setup
Selecting an Input Device
Use the dropdown in the app to choose from available input devices:
Built-in Microphone — captures both your voice and speaker output (recommended for most setups)
External Microphone — USB or audio interface microphones
Virtual Audio Device — for use with headphones (see below)
Click the refresh button next to the dropdown if a newly connected device doesn't appear.
Default Setup (No Headphones)
When using your Mac's built-in microphone and speakers, the microphone picks up both your voice and the remote participant's audio from the speakers. No additional configuration is needed — just select Built-in Microphone and start streaming.
Using Headphones
If you use headphones, the remote participant's audio goes directly to your ears and is no longer picked up by the microphone. To capture both sides, set up a virtual audio device to route system audio back to the app.
Using BlackHole (Free)
Install BlackHole:
Open Audio MIDI Setup (Applications → Utilities)
Create an Aggregate Device:
Click + → Create Aggregate Device
Name it "Interview Recording"
Check your microphone and BlackHole 2ch
Set your microphone as the clock source
Create a Multi-Output Device:
Click + → Create Multi-Output Device
Name it "Speakers + BlackHole"
Check your headphones and BlackHole 2ch
Set your Mac's sound output to Speakers + BlackHole (System Settings → Sound → Output)
In the status bar app, select Interview Recording as your input device
Now both your microphone and headphone audio (the remote participant) are captured.
Audio Level Meter
The visual meter shows real-time input volume:
Low
Green
Normal speaking volume
Medium
Yellow
Louder speech
High
Red
Too loud, may distort
If the meter shows no movement, audio is not being captured — check your device selection and permissions.
Settings
Click Settings in the app to access:
Auto-Updates
Toggle automatic update checks
Account
View your signed-in email and sign out
Version
Current app version and build number
Auto-Updates
The app checks for updates automatically using the Sparkle framework. When an update is available, you'll be prompted to install it. You can also manually check via Settings → Check for Updates.
Troubleshooting
App Doesn't Detect the Session
Verify you're signed in with the same account used in the web app
Check your internet connection
No Audio Being Captured
Check microphone permission in System Settings → Privacy & Security → Microphone
Verify the correct input device is selected
Try clicking the refresh button next to the device dropdown
Test your microphone in another app to confirm it works
WebSocket Connection Fails
Check your internet connection
The app retries automatically with increasing delays (up to 5 attempts)
If it persists, try signing out and back in to refresh your authentication token
Audio Only Captures One Side
If using headphones, set up a virtual audio device (BlackHole) as described in Using Headphones
If not using headphones, try switching to the built-in microphone — it picks up both speakers and your voice
Verify your Mac's sound output is set to the Multi-Output Device (headphone setup only)
Restart the app after creating new audio devices
App Icon Not Visible in Menu Bar
The app runs as a background process (no Dock icon)
Look for the headphones icon in the right side of the menu bar
If hidden, check if macOS is hiding it behind the notch — try expanding the menu bar area
Last updated