What it shows
- A dot per busy session. When nothing has run for two minutes, the raccoon on it falls asleep.
- A card when a session finishes, fails or needs an answer. View opens the session; Later puts the card away. A click anywhere on the card opens it too. A card goes away by itself after about 12 seconds, longer when there is more to read, and never later than 25 seconds. A short notice with nothing to open goes after 5.
- The list of sessions when you hover over it. Click a row to open that session.
- Approve and Deny when a headless agent asks to run a tool call. These cards wait for your answer. Approve counts only once the card has been up a moment and you moved the pointer to it, so a click meant for something else doesn’t approve.
Where it works
- Linux
- macOS
- Windows
It works on Wayland, with a compositor that has the wlr-layer-shell protocol, such as Hyprland or Sway. It doesn’t work on X11.
Agents outside Arakun
Windows only for now.
~\.claude\settings.json, with your own path to arakun.exe:
settings.json
arakun island hook <name> shows another name than “Claude Code”.
Any other agent can tell the island by hand:
Turn it off
Turn off Dynamic Island in Settings. The island runs as its own process,arakun island-host, and turning it off ends that process.
From a terminal
The island works with the app closed, so a script can use it too:sleeping, idle, working, speaking and listening. arakun island list pins or unpins the list of sessions.