Skip to main content
It is a small black shape that stays on top of whichever window is in front, so you can work elsewhere and still see when an agent needs you.

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.
Every notice also lands in the Inbox, so you can read it later.

Where it works

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 Code running in another terminal or an editor can show on the island through its hooks. Add this to ~\.claude\settings.json, with your own path to arakun.exe:
settings.json
The island lists the session while it works, and shows a card when it waits for you or finishes. The hook never fails, even when the island is not running. arakun island hook <name> shows another name than “Claude Code”. Any other agent can tell the island by hand:
View on such a card only puts it away, since Arakun has nothing to open for it.

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:
The states are sleeping, idle, working, speaking and listening. arakun island list pins or unpins the list of sessions.