Work berk.boz Projects

Back to projects

CodeIsland, my fork

Built on wxtsky/CodeIsland. CodeIsland is an open-source, MIT-licensed Mac app that turns the notch into a status panel for AI coding agents. Everything below is a set of changes on top of it, now open as pull requests upstream.

I run several Claude Code sessions at once. Each one stops now and then to ask whether it may run a command or edit a file. If I miss the question, the session just sits there. If I switch to answer it, I lose my place in whatever I was doing.

CodeIsland already puts those questions in the notch. I wanted it narrower: a panel that only speaks up when a decision is needed, lets me answer with one click, and never pulls me out of the window I am typing in.

A recreation of the permission card, with example content. The window behind it keeps focus.

What I changed

  • Permission-only mode. The notch stays folded until a session needs an answer. Progress, finished turns and chatter no longer open it.
  • It never steals focus. The panel answers clicks without becoming the active app, so the cursor stays where you were typing.
  • Real session titles. Sessions from the Claude desktop app show the title you see in its sidebar, not a folder name or an ID.
  • A compact list. One line per session, a status dot and its title, so a busy day still fits in the notch.
  • Usage and limits. A footer with how much of the Claude and Codex limits is used, and the same for a remote machine that runs agents.
  • Themes. Four colour themes for the panel.
  • Redrawn mascots. Clawd for Claude and Dex for Codex, redrawn on a boxy 16 by 16 pixel grid, with seven states.
The compact list and the usage footer, with example sessions.

Seven states, two mascots

The notch is small, so the mascot does the talking. Each pose is a state: idle, thinking, running, waiting for approval, waiting for an answer, done and error. Waiting for approval raises both arms, which is the one I wanted to catch from the corner of my eye.

Clawd, an orange pixel critter, and Dex, an off-white one with a blue antenna, in seven poses each: idle, thinking, running, approval, question, done and error
Clawd (Claude) on top, Dex (Codex) below, at full size and at notch size.

Going upstream

These changes belong in CodeIsland, not in a separate app. I split them into small pull requests for wxtsky/CodeIsland, one feature each, so the maintainer can take the ones that fit and leave the rest. All eight are open and not merged yet.

What it does not do

  • There is no download here. The fork stays private while the changes go upstream. When they land, they ship in CodeIsland itself.
  • It does not decide for you. Every permission is still your click. The panel only makes the question easier to see and answer.