Troubleshooting
// every warning documented honestly, every fix spelled out
Windows: "Windows protected your PC"
The public train requires Authenticode publisher and timestamp verification, but SmartScreen can still flag a certificate while it builds reputation. Click More info, verify the publisher matches the release notes, and proceed only then. Stop if the publisher is unknown.
macOS: "cannot be opened" / "is damaged"
A public release is required to carry a Developer ID signature and stapled Apple notarization ticket. This warning is therefore a trust failure, not an expected first-run step. Stop and report the release tag, asset name, Mac architecture, macOS version, and exact warning. Do not clear quarantine or use an unsigned-app override for a purported public release.
Updates
The built-in updater (System → Updates) supports Windows and both Mac architectures and verifies every update against a key baked into the app. This is independent of Authenticode, Developer ID signing, and notarization. The build contract is not installed-update evidence; report a failed update and use the matching current release installer when necessary.
The station browser will not load pages
If every page fails, agents report proxy or connection errors, or a new browser "exits before it
can be controlled", an earlier StarNet session may have left its browser running. Open
Settings → BROWSER → RESET STATION BROWSER. It closes the station browser, ends any copy
an earlier StarNet session left running on the station profile, and clears that profile's stale
locks. It never touches your own Chrome, and your saved sign-ins are kept. Agents can do the same
thing themselves with the browser.reset tool. StarNet also does this check on its own
before it starts the station browser.
If an agent is using the browser at that moment, stop the run first. If the reset reports a process it could not end, quit StarNet from the tray and restart your computer.
Erase everything and start over
Uninstalling removes only the program. Your station lives in a separate folder for your user
account, so a reinstall picks it right back up. To really start from scratch, open
Settings → APP & BACKUP → ERASE EVERYTHING, type ERASE, and click twice.
StarNet stops, deletes everything it keeps on this computer, and restarts at first run. When it
finishes it lists exactly what it removed, and anything it could not remove.
It deletes your station, agents, chats, memory, routines and settings, saved browser sign-ins, files agents saved inside StarNet, logs, the voice-model download, the keys and tokens StarNet saved in your system keychain, and the app window's own stored data. It also turns off Launch at login.
It does not touch project folders you let agents work in, files exported to
StarNet deliverables, your Downloads folder, your StarNet account and its credits (this
computer is just unlinked from it), or the StarNet app itself. Export a backup first
(EXPORT STATION, same page) if you might want any of it back.
Want a clean station but keep the old one on disk? Use START FRESH on the recovery screen instead: it moves the old station to a quarantine folder rather than deleting it.
Where StarNet keeps your data
Quit StarNet first (tray icon → Quit), or it will recreate files while you delete them. Then remove these by hand if you cannot use ERASE EVERYTHING:
- Windows
- Station data:
%APPDATA%\ai.skynet.harness\ - App window storage and voice-model download:
%LOCALAPPDATA%\ai.skynet.harness\ - Program:
%LOCALAPPDATA%\StarNet\(uninstall first; delete what is left) - Voice-model download from an older version, if it is still there:
%LOCALAPPDATA%\StarNet\models\ - Saved keys and tokens: Control Panel → Credential Manager → Windows Credentials, every
entry containing
ai.skynet.harness
- Station data:
- macOS
- Station data and voice-model download:
~/Library/Application Support/ai.skynet.harness/ - Voice-model download from an older version, if it is still there:
~/Library/Application Support/StarNet/models/ - App window storage:
~/Library/WebKit/ai.skynet.harness/,~/Library/Caches/ai.skynet.harness/and~/Library/HTTPStorages/ai.skynet.harness/if present - Saved keys and tokens: Keychain Access, search
ai.skynet.harness, delete each item - Launch at login (only if you turned it on): the StarNet item in
~/Library/LaunchAgents/
- Station data and voice-model download:
- Running from source: the
workspacesfolder you started it with (the repo'sworkspaces/by default, or the path inSKYNET_WORKSPACES).
In Finder, press Cmd+Shift+G and paste a ~/Library/... path to open it. In Windows,
paste a %APPDATA% path into the File Explorer address bar.
Uninstalling
- Windows: Settings → Apps → Installed apps.
- macOS: quit StarNet, drag it from Applications to the Trash.
Uninstalling keeps your station data. To remove that too, run ERASE EVERYTHING before you uninstall, or delete the folders listed in Where StarNet keeps your data.
Behind a VPN or corporate proxy
The app window honors your system proxy, but the engine's own outbound connections — AI providers and
messaging channels like Discord — go out directly and do not route through a proxy (Telegram is the one
exception: it honors HTTPS_PROXY / ALL_PROXY). On a
network that forces one, the UI and browser sign-ins can look perfectly healthy while runs and channel
connects fail with a plain network error. There is no proxy setting yet; you need direct access to the
provider and platform APIs. COPY DIAGNOSTICS (under any failed turn) shows whether a proxy is
configured on your machine.
Live Voice is slow to start the first time
Expected, once. Hands-free Live Voice runs on a speech engine inside the app rather than a cloud service, so the first session downloads the open Whisper and Kokoro model weights and caches them in your user profile — the panel shows that download's progress instead of pretending to listen. Once cached, local listening needs no network. Speaking stays local while Kokoro is available; otherwise StarNet may use the keyless Microsoft Edge Read Aloud fallback for answer text. If the panel refuses before opening your microphone, neither the local packages nor a supported offline operating-system dictation fallback is available.
Still stuck?
Open an issue on GitHub or email androo.agi@gmail.com. We'd rather hear about a broken thing than have you assume it's supposed to be that way.