~/orcamento
Quer um site ou sistema feito por mim?
Os projetos para clientes passam pela Web4Business, onde a equipe faz o orçamento.
~/redes
Onde me encontrar
- GitHubRepositórios, experimentos e projetos abertos.@cmacetko (abre em nova aba)
- LinkedInA trajetória profissional: mais de duas décadas construindo a web./in/cmacetko (abre em nova aba)
- InstagramO lado colorido: maquiagens, dia a dia e bastidores.@paloma_macetko (abre em nova aba)
- FacebookOnde compartilho a jornada com amigos e comunidade./cmacetko (abre em nova aba)
paloma_macetko:~/projetos/pensieve $ cat README.md
Pensieve
App gratuito de notas com lembretes: no navegador, no celular e no computador. Tem API, skill e servidor MCP para a sua IA anotar por você.
- React 19
- Express 5
- MySQL
- Electron
- MCP + OAuth 2.1
01 · Visão geral
Notas com lembretes, e sua IA anota por você
Um app de notas em cards, sem título e sem formatação: você escreve, ele guarda e avisa na hora certa. Lembretes são escritos em português ("amanhã às 10h"), com repetições, e chegam no navegador, no celular (PWA) ou no app para Windows, Mac e Linux. E, se preferir, sua IA anota por você pela API REST ou pelo servidor MCP.
Apps de notas ou são simples demais para lembrar de nada, ou complicados demais para anotar rápido. O Pensieve fica no meio: anotar leva um segundo, e o aviso chega sozinho — inclusive quando quem anotou foi a sua IA.
O que faz
- Notas em cards com listas coloridas, favoritas e arquivo
- Lembretes em português, com repetições e avisos em todo aparelho
- App para computador (Electron) e instalação no celular como PWA
- API REST com OpenAPI, skill para agentes e servidor MCP com OAuth
- Exportação das notas em JSON, Markdown ou CSV
02 · Galeria
Telas do produto no ar
Capturadas de pensieve.com.br. Clique numa tela para ver em tamanho real.
/Página inicial: o mural de notas com lembretes e o aviso da IA anotando por você./Integração com IA: uma chave, um cabeçalho e a skill pronta para o agente./desenvolvedoresPágina para quem desenvolve: API REST, skill para agentes e servidor MCP./downloadDownloads do app para Windows, macOS e Linux, alimentados pelos releases do GitHub./api/v1/docsDocumentação interativa da API em Swagger UI, gerada do OpenAPI 3.1.
03 · Stack
Do que é feito, camada por camada
Tirado do código-fonte e do que roda em produção.
Front-end
React 19 + Vite 8- SPA com React Router 7; as rotas públicas são pré-renderizadas no build para SEO.
PWA- Service worker com cache, notificações push e share target para receber texto de outros apps.
chrono-node- Base do lembrete em linguagem natural, com parsers próprios em português.
Back-end
Node.js + Express 5- API em ESM com sessão JWT em cookie httpOnly, helmet, rate limit e validação com Zod.
SSE- Tempo real: o mural se atualiza sozinho e o app desktop recebe os lembretes.
web-push- Notificações VAPID no navegador e no celular.
Dados
MySQL + mysql2- 14 tabelas, 16 migrations SQL aplicadas automaticamente ao subir a API.
FULLTEXT- Busca nas notas por prefixo, direto no índice do banco.
Desktop e distribuição
Electron 44- App para Windows, macOS e Linux com bandeja, nota rápida e protocolo pensieve://.
electron-builder + updater- Instalador NSIS, portátil, DMG e AppImage, com atualização automática.
GitHub Actions- Gera os builds das três plataformas e publica o release.
IA e integrações
MCP SDK- Servidor MCP próprio em Streamable HTTP para Claude, ChatGPT e afins anotarem por você.
OAuth 2.1- PKCE e registro dinâmico de cliente, com descoberta via .well-known.
Firebase Auth · Resend · Turnstile- Login com Google, e-mails transacionais e proteção contra bots.
Qualidade
Vitest + supertest- 272 testes no back-end, incluindo um que confere se toda rota documentada existe.
node:test · oxlint- Testes do app desktop e do front, e lint em todo o código.
04 · Destaques
Decisões técnicas que valem a leitura
Conector MCP com OAuth 2.1 de verdade
A IA descobre o servidor de autorização sozinha, a pessoa aprova na tela /autorizar e o token volta com PKCE. Também aceita API Key — no banco fica só o SHA-256 da chave.
Lembrete escrito em português
"Ligar pro dentista amanhã às 10h" ou "toda segunda às 9h" viram data e recorrência. O chrono-node entende pouco de português, então os parsers são próprios.
Tempo real sem WebSocket
Um único canal SSE avisa o mural quando algo muda e entrega os lembretes ao desktop, com ?since= para reenviar o que se perdeu enquanto o app estava fechado.
API que se documenta e se testa
O mesmo contrato gera o Swagger em /api/v1/docs e um skill.md para agentes de IA; um teste falha se alguma rota documentada não existir.
Desktop que se atualiza sozinho
O electron-updater lê um feed servido pela própria API a partir do release do GitHub. O login Google acontece no navegador e volta ao app pelo protocolo pensieve:// com um código de uso único.
Conta protegida em camadas
Confirmação de e-mail, código de 6 dígitos guardado como HMAC para ações sensíveis, Turnstile por formulário, bloqueio de e-mail descartável e sessões por dispositivo com geolocalização.