Gripe vs Castelo de Areia vs Construir Você Mesmo

Original · Flue vs Sandcastle vs Building It Yourself

11:073 min readElie Steinbock05/11/2026Computing/Software · Internet Technology

Key Takeaway

Criar pipelines de agentes de IA personalizados em TypeScript oferece controle total do fluxo e flexibilidade para utilizar assinaturas de modelos sem depender de abstrações de bibliotecas de terceiros.

Highlights

  • As bibliotecas Flu e Sandcastle não oferecem suporte às assinaturas de planos pagos como Claude Max ou Codex Max.

  • A biblioteca Flu utiliza a biblioteca Pi, a estrutura Hono e o interpretador bash em memória Just Bash para executar comandos em TypeScript.

  • O Sandcastle roda tarefas de IA em sandboxes isoladas via Docker e suporta loops contínuos no estilo Ralph.

  • A implementação própria do Inbox Zero gerencia a automação de ponta a ponta com Git Worktrees, comandos pnpm e notificações no Slack.

Timeline

  1. Apresentação do Flu e limitação de assinaturas

    O lançamento das bibliotecas Flu e Sandcastle trouxe novas abordagens para lidar com agentes de codificação em ambientes isolados. No entanto, a impossibilidade de conectar assinaturas ativas de modelos de linguagem levou à criação de uma arquitetura personalizada que permite alternar livremente entre Provedores de IA.

    • As ferramentas Flu e Sandcastle orquestram agentes de código em TypeScript.
    • A ausência de suporte para assinaturas dos planos Claude Max e Codex Max motivou o desenvolvimento de uma solução própria para o Inbox Zero.
  2. Recursos da biblioteca Flu

    A estrutura do Flu facilita o roteamento de chamadas de LLM com saída em formato JSON e o processamento de tarefas em webhooks. O uso do Just Bash substitui a necessidade de contêineres pesados para tarefas simples de leitura ou manipulação de repositórios. A persistência de estado ocorre diretamente em buckets R2 e o acesso a ferramentas externas como a CLI do GitHub oculta tokens de autenticação da IA.

    • O Flu combina o ecossistema do Pi e Hono para criar endpoints de agentes.
    • A ferramenta integra o Just Bash para executar comandos em um sistema de arquivos virtual em memória.
    • O armazenamento de sessões é feito via Cloudflare R2 e a execução de CLIs é isolada sem expor credenciais.
  3. Definição do fluxo ideal para tarefas no Linear

    A automação visa capturar chamadas de problemas no Linear, aplicar correções acompanhadas de testes e simplificar a estrutura do código antes da revisão. O agente lida recursivamente com comentários enviados por bots de análise de código e emite relatórios do estado final no Slack.

    • O fluxo desejado processa demandas do Linear desde a leitura até o envio ao GitHub.
    • O processo inclui etapas automatizadas de desenvolvimento orientado a testes (TDD) e refatoração com o comando simplify.
  4. Análise do Sandcastle e loops de agentes

    Desenvolvido por Matt Pocock, o Sandcastle fornece estruturas para executar comandos usando contêineres e gerenciar ambientes isolados através de Git Worktrees. Sua execução baseia-se em ciclos contínuos de verificação onde o agente realiza tarefas sequenciais até atingir a finalização do escopo proposto.

    • O Sandcastle executa código de agentes em ambientes Docker com suporte a Worktrees.
    • A ferramenta adota padrões do loop Ralph para iterar até a conclusão total da tarefa.
  5. Implementação prática e controle no Inbox Zero

    O projeto open source Inbox Zero utiliza uma abordagem customizada que executa tarefas do Linear categorizando entre correção de falhas ou novos recursos. Embora contenha mais código do que as abstrações de bibliotecas prontas, a estrutura oferece controle exato sobre cada passo do desenvolvimento, permitindo ajustes nos prompts e no comportamento da aplicação sem dependências externas.

    • A solução própria orquestra as sete etapas do ciclo de vida da tarefa via comandos nativos de sistema.
    • O script gerencia a criação de Worktrees, atalhos de variáveis de ambiente e execução via pnpm.

Description

ScreenshotOne: https://screenshotone.com/?utm_source=youtube&utm_medium=sponsorship&utm_campaign=eliezer_steinbock Flue: https://flueframework.com/ Sandcastle: https://github.com/mattpocock/sandcastle Inbox Zero: https://getinboxzero.com Two new TypeScript AI agent libraries dropped recently: Flue by the Astro team and Sandcastle by Matt Pocock. I walk through both, then show why I built my own agent harness for Inbox Zero instead. 0:00 - Two New TypeScript AI Agent Libraries 1:00 - Flue: Cloudflare-native Agent Framework 5:40 - Sandcastle by Matt Pocock 8:00 - Why I Built My Own (Linear to PR Workflow) 10:50 - Final Thoughts If you'd rather use a library than write your own, Flue and Sandcastle are both worth a look. Otherwise, this video shows the seven steps I wired up myself. =================== My open source product, Inbox Zero: Inbox Zero organizes your inbox, drafts replies in your voice, and helps you reach inbox zero fast. Never miss an important email again. https://getinboxzero.com GitHub: https://github.com/elie222/inbox-zero ⭐ =================== Follow me on X: https://x.com/elie2222 Join the Newsletter: https://aiopensource.substack.com/ #typescript #aicoding #claudecode #codex #aiagents #flue #sandcastle #devtools #inboxzero #orchestrator

Write about this video