Anderson LimaSoftware Engineer & Architect
16 de octubre de 2026
5 min de lectura
41 visualizaciones
Como o app macOS do lemon-code conversa com o CLI por JSON-RPC sobre stdio, sem reimplementar o agente e sem tocar no banco do core
English summary: How lemon-code's native macOS app sits on top of the CLI through a JSON-RPC 2.0 contract over stdio, with capability negotiation, degraded mode and a hard rule against writing to the core database.
Publicado: 2 de novembro de 2026
Tempo de leitura: 9 min
Série: lemon-code em 30 dias, parte 7 de 13
O primeiro commit do app macOS do lemon-code, em 16 de maio de 2026, não tinha nenhuma tela. A mensagem era "define app contract and execution rules". A janela só apareceu no commit seguinte.
Essa ordem foi a decisão mais importante do app. Este post mostra como um app SwiftUI pode ficar por cima de um CLI sem reescrever o agente em Swift, e as regras que mantêm os dois em pé.
Pense no painel de um carro. Ele mostra velocidade, combustível e alertas, e tem botões que mandam comandos. Mas ele não queima gasolina. Se você trocar o painel, o motor continua igual.
O app é o painel. O CLI é o motor. A regra número um do repositório do app diz isso com outras palavras: manter o lemon-code como único motor de execução.
As operações do agente e as mudanças no estado do core passam pelo CLI; a UI do app não abre o SQLite. O terminal embutido é separado: o app inicia o processo filho e controla o PTY usando a configuração devolvida pelo CLI.
O contrato é JSON-RPC 2.0, uma mensagem por linha, sobre a entrada e saída padrão do processo do CLI. O app envia lc.app.initialize sem parâmetros; a resposta traz contractVersion (app.v2), sessionId, serverInfo e capabilities.
{"jsonrpc":"2.0","id":1,"method":"lc.app.initialize"}
O app inicia o processo do CLI, escreve uma linha e lê a resposta correspondente. A lógica do agente continua no CLI; a interface Swift também é dona do PTY do terminal embutido.
Productos gratuitos y de pago para convertir ideas en una base que puedas lanzar.
13 productos disponibles
nextjs · boilerplate
Boilerplate de API em Python com FastAPI, organizado em Clean Architecture (router, service, repository e adapters por módulo). Inclui autenticação JWT com hashing bcrypt, MongoDB, testes com pytest e cobertura, Dockerfile e docker-compose para subir localmente, e documentação Swagger/OpenAPI automática. Repositório de origem privado; snapshot técnico verificado antes da publicação.
Ver producto
react · boilerplate
Base React Native para apps iOS y Android con Expo, Clean Architecture, MVVM, Firebase y módulos nativos. Referencia técnica de VaiDeFut, con distribución pública en Google Play y un flujo de publicación para iOS documentado.
Ver producto
nextjs · boilerplate
Kit gratuito y open source para comenzar con agentes de código en Claude Code, Codex, Gemini, Copilot y OpenCode. El repositorio público confirma una licencia MIT.
Ver producto
nextjs · boilerplate
Base AI-first white-label para lanzar productos SaaS con Next.js, chat, RAG, memoria, tenants y documentación. El snapshot verificado documenta Supabase, no MongoDB; la limitación está explícita. MongoDB, Redis y RabbitMQ requieren una integración/configuración compatible.
Ver producto
nextjs · boilerplate
Edición avanzada de una base white-label y multi-tenant AI-first para acelerar productos con Next.js, chat, RAG, memoria y documentación. El snapshot verificado no demuestra una capa Ultra distinta; la limitación y los cambios de provider, cache y colas quedan transparentes.
Ver producto
nextjs · boilerplate
Base white-label y multi-tenant para convertir una idea en un SaaS AI-first con Next.js, chat, RAG, memoria y seguridad documentada. El snapshot verificado usa Supabase; el nombre identifica el repositorio de origen. Los límites de provider, cache y colas son explícitos; Redis y RabbitMQ son integraciones configurables.
Ver producto
react · portfolio
Una contribución única para apoyar contenido técnico gratuito, investigación y la continuidad de proyectos relevantes publicados por Anderson Lima. Tú eliges el valor; no es una suscripción.
Ver producto
react · boilerplate
Starter React gratuito para crear una suite de pruebas confiable desde el primer commit con Vitest, Testing Library, Playwright, Vite, TypeScript, Zustand, React Query, MirageJS y PWA. El repositorio no declara una licencia SPDX; revisa sus términos antes del uso comercial.
Ver producto
react · portfolio
Monorepo público en React, TypeScript y Vite para explorar una biblioteca de componentes con lenguaje visual inspirado en interfaces nativas. El README actual es breve y no declara una licencia SPDX; trátalo como preview gratuito.
Ver producto
nextjs · saas
Boilerplate SaaS AI-first con Next.js, Supabase, Stripe y provider routing para avanzar desde el primer prompt hasta un despliegue real más rápido. Los cambios de IA, datos, email, cache y colas son explícitos; Redis y RabbitMQ son integraciones configurables.
Ver producto
react · saas
Starter React + TypeScript para SaaS multi-tenant con Firebase, Atomic Design, temas, PWA, pantallas de producto, MirageJS y chat Gemini extensible a otros providers. Valida requisitos de producción, costes e integraciones antes de publicar.
Ver producto
react · boilerplate
Starter React público con TypeScript, Zustand, React Query, Tailwind CSS, PWA e integraciones de IA documentadas. El repositorio no declara una licencia SPDX; revisa sus términos antes del uso comercial.
Ver producto
nextjs · saas
Landing SaaS para Next.js, TypeScript y Tailwind CSS con SEO, temas, i18n, PWA y puntos de integración para auth, Stripe e IA. Una base clara para dejar atrás la pantalla en blanco y dar forma a tu propuesta.
Ver productoContinúa explorando temas similares
Um lock momentâneo no SQLite abria o circuit breaker do meu app, que passava a mostrar dados de fallback e um aviso que tapava o campo de digitação. A correção coube em cinco regras.
O lemon-code tem seis ADRs com o número 0049, todas criadas no mesmo dia. Esse erro ensina mais sobre memória de projeto com vários agentes do que qualquer ADR bem numerada.
Eu pagava API para tarefas que o Claude Code ou o Codex, já logados na minha máquina, resolveriam. A regra CLI-first do lemon-code cabe em quatro linhas de precedência.
Una lista de 47 puntos para encontrar errores, riesgos de seguridad y problemas de rendimiento antes del lanzamiento.
Templates probados en producción, usados por desarrolladores. Ahorra semanas de setup en tu próximo proyecto.
O contrato separa dois planos:
lc.app.*: projetos, threads, aprovações, review, automações, instalação.Um exemplo concreto é o chat. O lc.app.chat.send executa o prompt pelo mesmo controlador do CLI, grava as mensagens na sessão e devolve a procedência da rota: provider e modelo pedidos, os realmente usados, as tentativas em ordem e se houve fallback. O lc.app.chat.cancel cancela só a requisição com aquele requestId, e o cancelamento é terminal: não dispara outra tentativa de fallback.
Outro exemplo é o terminal embutido. O CLI devolve só a configuração (diretório, shell de login, argumentos, ambiente) e o app é dono do PTY e do processo filho. Cada lado fica com o que sabe fazer.
Aqui está o erro que a ADR 0058 corrigiu. O risco era o app interpretar um initialize bem-sucedido como suporte a qualquer feature opcional. Com um CLI mais antigo, o app mostrava um botão que o core não sabia executar.
A regra hoje:
lc.app.getCapabilities anuncia cada feature opcional junto com os métodos que a implementam.agentRooms: true se o conjunto mínimo de métodos não estiver registrado.Um teste de integridade no CLI impede anunciar uma capability sem método correspondente.
Se o backend não estiver rodando, o app abre em modo degradado. Se a conexão JSON-RPC falhar, aparece um aviso no topo que pode ser fechado e não bloqueia a digitação. Parece detalhe. Na prática, é o que separa um app que você usa todo dia de um que você fecha irritado.
Com dados do Git: o app tem 152 commits entre 16 de maio e 12 de outubro de 2026. Requer macOS 13 e Swift 5.9, e roda com swift build e swift run LemonCodeApp.
Um app nativo por cima de um CLI funciona quando o contrato vem primeiro e o app aceita ser painel. O motor fica num lugar só, testado por CLI, TUI e RPC. O SwiftUI cuida do que faz bem: janelas, atalhos, terminal embutido e notificações.
Na quarta, o assunto é observabilidade: como manter o Collector sob seu controle e deixar o conteúdo da conversa fora da telemetria.
Se o seu time quer um app desktop por cima de uma ferramenta de linha de comando existente, desenhar esse contrato é um trabalho que faço na LEMON.DEV.