V-Sag

Scout · Support · Privacy · Terms

Support

Help with Scout, the Mac app that gives your AI agents a place in the notch.

Write to me

Questions, a bug, an idea: write to info@v-sag.com. Tell me your Mac model and macOS version, and what you did just before the problem. I read every message.

Getting started

The notch. Move the pointer to the notch at the top of the screen (on a Mac without a notch, to the top centre) and it opens into one screen of widgets: your agents, Ask AI, the Mac's load, today and what is playing. If you would rather keep the notch closed when you point at it, Settings › Notch › Pointing at the notch can show a list of your agents instead, or nothing. The icons along the top switch between the dashboard, Agents, Ask AI, Calendar (with your to-dos), Clipboard, Prompter, Music, Notes, Radio and Mirror, and the little lock beside the gear keeps your favourite one as the view the notch opens on. Files dropped on the open notch can be kept in the Tray, sent by AirDrop or converted.

Your agents. Claude Code and Codex sessions running on your Mac appear by themselves, each as a small pixel character: on the dashboard's little TV, in the Agents view (a room where every running agent has its own spot; click one to open its window) and, when the notch is closed, as up to four tiny faces beside the camera. Nothing to connect. To allow, deny or answer them from the notch, open Settings › Agents and click Connect Claude Code… (or Connect Codex…), then choose the .claude (or .codex) folder in your home folder. Disconnect takes it away again. Codex asks you to trust the new hooks once: type /hooks in Codex. Both agents can ask for permission that way; Claude Code can also ask you questions.

The look. The notch has two looks: 8-bit, the 90s look that is on by default, and minimal. Switch between them in Settings › Appearance. Appearance also holds the System, Light or Dark setting, the accent colour, the Classic or Glass notch and its size.

Settings. Click Scout's little face in the menu bar (a square face with two eyes) and choose Settings. If the menu bar is full, macOS can hide the icon behind the notch: open Scout again from your Applications folder or Spotlight and Settings opens.

Common questions

What do the pixel faces mean? Claude Code's agents lean orange and Codex's lean green, and each has hair, a cap or a bow of its own. Wide eyes and an amber outline: it needs you. Happy arches: it finished and it is your move. Crosses for eyes: its last step failed. Eyes shut: it is asleep. Otherwise it is working.

Why does Scout ask for a permission? Only when you first use a feature that needs it: Screen Recording for Ask AI's Screen switch, the Microphone and Speech Recognition for the Prompter, the Camera for the Mirror, Calendars for the calendar, Location for local weather (a chosen city works without it), Bluetooth to show your AirPods when they connect, Notifications for timers and alarms, your Downloads folder if you switch on download progress, Accessibility (optional) to paste from the clipboard history. You can turn any of them off in System Settings › Privacy & Security.

How do I use Ask AI? Ask AI uses your own API key from Anthropic (Claude) or OpenAI. Paste it in Settings › Ask AI. Scout keeps it in your Mac's Keychain and sends your questions straight to the provider you chose. The Screen switch sends a picture of your screen with your question (Scout's own windows are left out); it starts off and needs the Screen Recording permission.

The Prompter follows the sound of my voice, not my words. To follow word by word, Scout uses the speech recognition built into macOS, on your Mac. If Dictation is off (System Settings › Keyboard) or your language cannot be recognised offline, Scout follows the sound of your voice instead: the text moves while you speak and waits when you stop.

Does Scout cost anything? Scout is free at launch, with every feature included. No account, no ads, no in-app purchases.

More

Read how Scout treats your data (it collects none) and the terms of use.