diegogontijo

Dynamic Island AI Agents — AI skill for Claude Code

AI community

macOS notch 'Dynamic Island' that shows your remaining Claude Code and Codex 5-hour usage limits.

How to install Dynamic Island AI Agents

This entry records only its repository, not the path inside it, so there is no exact command to give. Open diegogontijo/dynamic-island-ai-agents and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Dynamic Island AI Agents does

macOS notch 'Dynamic Island' that shows your remaining Claude Code and Codex 5-hour usage limits.

Alternatives in AI

  • Claude Usage Tracker — Native macOS menu bar app for tracking Claude AI usage limits in real-time 2.2k ★
  • Token Monitor — Local-first desktop widget for tracking token usage, costs, and limits across 32+ AI coding tools—including Cl 1.8k ★
  • MioIsland — macOS Dynamic Island for AI coding agents 388 ★

README

Logo do Agent Island

Agent Island

Transforma o notch do MacBook numa "Dynamic Island" que mostra quanto ainda resta dos seus limites de uso do Claude Code e do Codex.

![Painel do Agent Island aberto sobre o notch, mostrando os limites de 5 horas e semanais do Claude Code e do Codex](docs/screenshot.png)

Clique no notch e um painel se abre com:

  • a porcentagem restante da janela de 5 horas de cada ferramenta e quanto tempo falta para ela reiniciar
  • o limite semanal de cada uma, com a data de reinício

Com o painel fechado, o notch fica com a aparência normal.

Requisitos

  • macOS 14 (Sonoma) ou mais recente
  • Mac com Apple Silicon (M1 ou mais novo)
  • Ferramentas de linha de comando do Xcode com Swift 6 ou mais recente. Se ainda não tiver, instale com:
    xcode-select --install
  • Pelo menos um destes CLIs instalado e com login feito:

O app usa os logins que esses CLIs já salvaram no seu Mac. Não há nenhuma chave ou configuração extra.

Instalação

git clone https://github.com/diegogontijo/dynamic-island-ai-agents.git
cd dynamic-island-ai-agents
./scripts/build.sh --install

O script compila o app, gera `build/AgentIsland.app`, copia para `/Applications` e abre. Para só compilar, sem instalar, rode `./scripts/build.sh` sem argumentos.

Na primeira execução:

  • O macOS pode pedir permissão para acessar o item "Claude Code-credentials" do Keychain. Clique em Permitir sempre.
  • O app é registrado para abrir ao iniciar sessão. Para desativar, use o menu da barra de menus.

Uso

  • Clique no notch para abrir o painel. Ele fecha ao clicar fora ou ao tirar o mouse de cima.
  • O