Reference
Troubleshooting
What to do when the key isn't accepted, macOS won't open the app, the agents don't change state, the window doesn't appear or something else doesn't work as it should.
First of all: in a workspace, Workspace settings → Diagnostics → Check verifies in one click the folder, Claude Code, curl, git and the link between agents and app. Every line that's wrong says what to do.
Install and licence
The key isn't accepted. The line under the field says why:
| Message | What to do |
|---|---|
| This token does not exist | Check you copied all of it, from gloop_ to the last character. |
| It has been revoked, or has expired | Ask whoever gave it to you for a new token, or a renewal. |
| The group has been turned off or has expired | The token belongs to a group (a company, a team) that's no longer valid: ask whoever manages the group. |
| The request is not valid | Update the app and try again. |
| Too many attempts from this network | Wait a few minutes. |
Does Gloop start without a network? Yes, for 7 days from the last licence check.
On Mac: "Gloop can't be opened" or "is damaged". It's the first-open block: go to System Settings → Privacy & Security and choose Open Anyway. If you opened it from the .dmg, drag it into Applications first.
On Windows: "Windows protected your PC". Choose More info and then Run anyway.
Updates don't arrive (Mac). Gloop updates itself only if it lives in a folder it can write to, like Applications. Opened from the .dmg, or from a read-only folder, it can't replace itself.
Agents
"Can't find the claude command". Install Claude Code and sign in from a terminal, then restart Gloop. On Mac Gloop reads your login shell's PATH, so if claude works in Terminal it works here too. Meanwhile the shells work.
The agents always stay the same colour. Agents tell how they're doing with curl, towards the app on your computer (127.0.0.1). If Diagnostics says curl can't reach the app, a firewall or an antivirus is blocking local connections: allow Gloop, or 127.0.0.1.
An agent shows as working even though it finished answering. It has probably sent subagents that haven't reported back yet: look in the session panel. You can stop them from there.
The yes to a permission doesn't go. Gloop types the yes in the terminal only when Claude Code's question is really on screen. If the card stays, answer in the terminal.
I don't see the plan's limits. Claude Code sends them only with some subscriptions, and only after an agent's first answer. Type /usage in a pane.
Pasting an image doesn't work. In an agent pane, Ctrl+V passes Claude the image on the clipboard only if there isn't also text on the clipboard.
Window and graphics
At start the window doesn't appear. It happens with some graphics cards (for example with two cards, Intel and NVIDIA). Gloop notices by itself: after 10 seconds it turns hardware acceleration off and restarts. You turn it back on in Settings → App → App rendering, from the next start.
Odd characters or flicker in the terminals. Turn off Use the graphics card (WebGL) in Settings → Terminal.
The Brain's graph doesn't open. It needs 3D graphics (WebGL), which is missing in a remote desktop, for example. The index of notes works anyway.
The command bar's combination doesn't work. Another program already uses it: Gloop says so in Settings → Notch, where you pick another.
Git and branches
I don't see branches, changed files or "Agent in a branch". You need git, and the workspace's folder must be a repository. These features aren't there in Custom.
Creating a worktree takes long. On a big repository, with Windows and tools like git lfs, it can take a few minutes: Gloop waits up to 10.
Scout on Windows: "paths too long". A branch's copy lives in a deeper folder, and some files go over 260 characters. Turn on git's long paths (git config --global core.longpaths true) and try again.
Still nothing?
Save the log to share (Settings → App → Log → Save to share) and write to us on Discord, or send a report from the app: see Data and privacy.