Deixe o Claude Code trabalhando em quantos terminais quiser e vá fazer outra coisa. O notch mostra quem está trabalhando, quem terminou e quem precisa de você — e deixa você responder dali, sem trocar de janela.
macOS 13 ou mais novo · hooks locais · nada sai do Mac
~/dev/notchbar $ claude › roda os testes do HUD e corrige o que falhar ● Read tools/hudtest/main.swift ● Edit Sources/NoticeViews.swift +6 −2 ● Bash swift build -c release && bash tools/test-hud.sh aguardando permissão…
Pílula com o projeto e os pontos respirando. Clique e volta para a aba certa do Terminal ou do iTerm (pelo tty) — ou para o VS Code, Cursor, Warp, Ghostty: o app que rodou o agente.
O comando ou o arquivo inteiro, com Permitir · Negar · Sempre e um anel com o prazo que você escolheu (30 s a 5 min). ⌃⌥Y e ⌃⌥X respondem de qualquer app.
O notch expande por 8 s com o fim da resposta e fica compacto até você ver: clique abre o terminal, o × dispensa. Erro de API (como limite atingido) aparece em vermelho.
O agente parou esperando uma resposta no terminal. O notch expande com a pergunta e fica marcado até você ver.
Na meia roda da bandeja: cada sessão com estado, tempo, ferramenta em uso e o pedido pendente com Permitir/Negar. No rodapé, o uso do dia — quantas sessões e quanto tempo de agente.
Se o limite está crítico enquanto um agente trabalha, a pílula dele ganha o %. Em 100%, a contagem até liberar; ao liberar, “Sessão liberada”.
Com um agente trabalhando e sem música tocando, as luzes da bandeja mudam para coral — dá para saber de longe que tem coisa rodando.
O Notchbar grava um script em ~/Library/Application Support/Notchbar/hooks/ e acrescenta os hooks dele no ~/.claude/settings.json — depois de guardar uma cópia em settings.json.notchbar-backup. O resto do arquivo não muda.
As sessões novas já avisam o notch. Escolha o prazo dos pedidos (30 s, 1, 2 ou 5 min), se quer som e quais avisos aparecem.
O mesmo botão vira Desinstalar: remove as entradas do Notchbar e deixa os seus hooks onde estavam.
# ~/.claude/settings.json — o que o Notchbar acrescenta
{
"hooks": {
"SessionStart": [{ "hooks": [{ "type": "command",
"command": "\"…/Notchbar/hooks/notchbar-hook\" SessionStart",
"timeout": 10 }] }],
"UserPromptSubmit": [ … o mesmo, com o nome do evento … ],
"Notification": [ … ],
"Stop": [ … ],
"StopFailure": [ … ],
"SessionEnd": [ … ],
"PreToolUse": [{ "matcher": "*", "hooks": [ … ] }],
"PermissionRequest":[{ "matcher": "*", "hooks": [{ "type": "command",
"command": "\"…/notchbar-hook\" PermissionRequest",
"timeout": 620 }] }]
}
}
Um script bash, sem dependências (sem jq, sem Python). Os outros hooks que você já tem continuam rodando junto.
PermissionRequestagents/inboxagents/replies; o script devolve ao Claude CodeO que o Notchbar lê: o que o Claude Code passa aos hooks — a pasta do projeto, a ferramenta em uso, o comando ou o arquivo de um pedido e o fim da resposta. Cada evento é um arquivo temporário apagado assim que o app lê; o resto fica só em memória. Nada sai do Mac. Detalhes na política de privacidade.
Qualquer coisa que rode no Mac pode avisar o notch com notchbar://agent. O agente aparece na seção Agentes como os do Claude Code — trabalhando, pronto, erro ou esperando você.
Eventos: start · tool · done · error · waiting · end. Parâmetros: name, project e message (opcional). Pedidos de permissão com Permitir/Negar são só do Claude Code, que tem o hook de decisão.
# um aviso solto
open "notchbar://agent?event=done&name=Codex&project=api&message=Testes%20ok"
# embrulhar qualquer comando longo (~/.zshrc)
notch() {
local p="${PWD##*/}"
open "notchbar://agent?event=start&name=$1&project=$p"
"$@"; local s=$?
open "notchbar://agent?event=$([ $s -eq 0 ] && echo done || echo error)&name=$1&project=$p"
return $s
}
# notch codex exec "corrige os testes"
# notch npm run build
Não na prática. Os eventos de trabalho são instantâneos: o script grava um arquivo pequeno e sai. Só o pedido de permissão espera — no máximo o prazo que você escolheu, e só com o Notchbar aberto. Sem resposta, o terminal pergunta como sempre.
Sim. Cada sessão aparece na seção Agentes (até 12 de uma vez). Pedidos de várias sessões entram em fila no notch; ⌃⌥Y e ⌃⌥X respondem o da frente.
Os hooks rodam onde o Claude Code roda. O Notchbar só enxerga sessões no próprio Mac; numa máquina remota, use notchbar://agent a partir de um script local, se quiser.
Continuam lá. O Notchbar acrescenta um grupo dele em cada evento e marca as entradas pelo caminho do script — é por ele que a desinstalação acha o que tirar. Um backup do arquivo fica ao lado antes da primeira mudança.
Não. Com ele aberto, o % do limite do Claude aparece junto quando importa; sem ele, os agentes funcionam igual.
Não. O Notchbar é um app independente da BigHeadStudios. Claude e Claude Code são marcas da Anthropic; o Notchbar usa os hooks públicos do Claude Code, documentados pela própria Anthropic.
48 horas grátis, depois R$ 10 por Pix, para sempre — o Notchbar inteiro, não só os agentes.