Construí um Bloco de Notas Flutuante para Sessões de Código com Claude (SwiftUI + MCP)

O Problema Com o Qual Você Aprende a Conviver

Eu uso o Claude Code por horas todos os dias. Com o tempo, notei um padrão que continuei ignorando: evaporação de contexto.

Você está 45 minutos em uma sessão. Claude te avisou sobre uma mudança crítica, tomou decisões arquitetônicas com as quais você concordou, criou TODOs para casos extremos, sinalizou uma questão de segurança para revisar mais tarde. Onde está tudo isso agora? Enterrado na rolagem do terminal. Você se lembra vagamente do aviso. Os TODOs desapareceram.

Tentei resolver isso com pequenas soluções alternativas. Criei um alias de shell (here='pbpaste | bat -l md -p') para colar e ler rapidamente a saída do Claude como markdown formatado. Copie algo importante, mude de painel, execute here, continue trabalhando. Tentei manter um arquivo de texto aberto ao lado do meu terminal. Cada solução alternativa durou alguns dias antes que a fricção vencesse. No momento em que me aprofundei em um problema, parei de fazer isso.

Você também pode perguntar diretamente ao Claude: "quais eram os TODOs de antes?" Mas isso significa rolar para trás, reler o contexto, gastar tokens na recuperação em vez de no trabalho. Em sessões longas, isso se acumula.

O que me fez realmente construí-lo foi ver frustrações semelhantes no X. Pessoas descrevendo a mesma coisa: contexto importante das sessões do Claude Code desaparecendo na rolagem. Não era apenas meu problema. A ideia de um quadro negro, algo como um quadro flutuante de post-it para sessões de codificação, continuava voltando. Depois da terceira vez que me peguei perguntando novamente ao Claude sobre algo que ele já havia me dito, decidi parar de remediar o problema e construir a solução.

Como Mais Você Poderia Resolver Isso?

Antes de construir qualquer coisa, olhei para o que já existe.

1. CLAUDE.md e Arquivos de Memória

O Claude Code tem persistência embutida: CLAUDE.md para instruções do projeto, arquivos de memória para recordação entre sessões. Estes são ótimos para contexto de longo prazo (convenções de projeto, preferências do usuário). Mas não são projetados para anotações rápidas dentro de uma única sessão. Escrever "lembre-se de verificar o middleware de autenticação" em um arquivo de memória é exagero. Isso polui o armazenamento de longo prazo com contexto efêmero.

2. TodoWrite (Ferramenta de Tarefas Integrada)

A ferramenta TodoWrite do Claude Code rastreia tarefas dentro de uma sessão. Funciona, mas:

• É invisível. Você não pode dar uma olhada rápida. Você tem que perguntar ao Claude "quais são meus todos?" para vê-los.
• É unidirecional. Claude escreve, você lê (perguntando). Você não pode adicionar seus próprios itens.
• Desaparece completamente quando a sessão termina, sem opção de revisão.

3. Aplicativos de Produtividade com MCP (Obsidian, Notion, Todoist, Apple Notes)

Esta é a alternativa mais próxima. O Obsidian tem MCP de memória básica, Notion e Todoist têm seus próprios servidores MCP. O Claude pode ler e escrever para todos eles. Eu realmente uso Obsidian + MCP diariamente para contexto de projeto de longo prazo.

O Apple Notes também tem vários servidores MCP bem construídos (sweetrb/apple-notes-mcp é o mais completo, com 18+ ferramentas incluindo consciência de sincronização e operações em lote; RafalWilinski/mcp-apple-notes adiciona pesquisa semântica no dispositivo com embeddings vetoriais).

Então, o Claude pode escrever nesses aplicativos. O problema não é o acesso, é a incompatibilidade de propósito:

• Armazenamento permanente para contexto efêmero: Estas são bases de conhecimento. Escrever "verifique o middleware de autenticação antes de mesclar" no seu cofre do Obsidian ou Apple Notes cria ruído que você terá que limpar mais tarde. Anotações rápidas da sessão não pertencem a um gráfico de conhecimento permanente.
• Não é visualizável: Estes são aplicativos completos que você alterna com Cmd+Tab. Não um painel flutuante que você dá uma olhada enquanto digita no seu terminal. Essa troca de contexto, mesmo que rápida, quebra o fluxo.
• Sem ciclo de vida da sessão: O MCP permite que Claude escreva nesses aplicativos, mas não há conceito de "esta nota pertence a esta sessão de codificação e deve desaparecer quando a sessão termina." Você precisaria organizar e excluir manualmente as notas da sessão.

4. Multiplexador de Terminal (painel tmux)

Divida seu terminal. Dedique um painel a um arquivo de anotações rápidas. Existem até servidores tmux MCP que permitem que Claude envie comandos para outros painéis. Mas:

• Texto, não UI: Claude pode enviar texto para um painel, mas ainda é um fluxo plano. Sem anotações digitadas (nota vs todo vs aviso), sem alternâncias de conclusão, sem hierarquia visual. Você está lendo texto bruto em uma grade monoespaçada.
• Mesmo canal cognitivo: A saída do terminal e as anotações rápidas são ambos texto no mesmo contexto visual. Seus olhos têm que distinguir "isto é a saída do código" de "esta é uma nota que eu devo lembrar." Um painel flutuante em uma camada visual diferente separa isso naturalmente.
• Sem ciclo de vida da sessão: O painel não sabe quando uma sessão do Claude Code começa ou termina. As notas se acumulam entre as sessões, a menos que você as limpe manualmente.

Divulgação completa: eu uso Ghostty, não tmux. Se o tmux tiver capacidades que abordem esses pontos melhor do que eu percebo, adoraria ouvir sobre isso nos comentários.

5. Gerenciadores de Área de Transferência

Ferramentas como Maccy ou Paste capturam tudo o que você copia. Mas são reativas (você precisa copiar primeiro) e não têm conceito de "este é um contexto importante de uma sessão de IA" vs "copiei uma URL há 20 minutos atrás."

A Lacuna

O ecossistema MCP resolveu o problema de "Claude não pode escrever em aplicativos externos". Claude pode escrever para Obsidian, Apple Notes, Notion, Todoist, painéis tmux. O acesso não é o problema.

O que está faltando é uma combinação de três coisas que nenhuma ferramenta existente fornece juntas:

• Ciclo de vida da sessão: Notas que pertencem a uma sessão de codificação e desaparecem quando ela termina. Sem limpeza, sem ruído permanente.
• Visualizabilidade: Um painel flutuante visível ao lado do seu terminal o tempo todo. Não atrás de um Cmd+Tab, não enterrado em um painel.
• Estrutura: Anotações digitadas (nota, todo, aviso) com distinção visual, não um fluxo de texto plano.

Arte Prévia

mattt/iMCP é o par arquitetônico mais próximo do que acabei construindo: um aplicativo nativo para macOS SwiftUI emparelhado com um servidor CLI MCP, construído com o SDK oficial MCP Swift (que mattt co-criou). iMCP conecta Calendário, Contatos, Mensagens, Lembretes e Clima ao Claude. Ele usa Bonjour para descoberta entre os processos do aplicativo e do CLI.

Clause se baseia nesse padrão (aplicativo nativo + servidor CLI MCP, modelo de dois processos), mas difere em escopo e intenção. iMCP é uma ponte de propósito geral para os aplicativos integrados da Apple. Clause é um bloco de notas efêmero de propósito único. iMCP não armazena nada novo; ele lê e escreve para serviços da Apple existentes. Clause cria seu próprio estado transitório que vive e morre com uma sessão de codificação.

Quem Precisa Disso?

Nem todo mundo. Se suas sessões do Claude Code são curtas (menos de 15 minutos) ou focadas em edições de um único arquivo, você provavelmente não precisa do Clause.

Mas se você:

• Realiza sessões longas (30+ minutos) onde Claude toma várias decisões e sinaliza problemas
• Trabalha em refatorações complexas que abrangem muitos arquivos e acumulam avisos
• Usa o Claude Code como um programador parceiro, não apenas como um gerador de código
• Se pegou rolando para trás pelo histórico do terminal procurando "aquela coisa que o Claude disse antes"
• Quer um espaço de trabalho compartilhado onde tanto você quanto o Claude possam rastrear o contexto da sessão

Então o Clause resolve um problema real.

Na minha rotina