Zeltro CLI

O Zeltro é um gerenciador de ambientes de desenvolvimento local baseado em Docker para projetos PHP, Python e Node — e um conjunto de limites de segurança para os agentes de IA que trabalham no seu computador.

Ele faz três coisas, e uma reforça a outra.

Um único conjunto de serviços para todos os projetos#

Um zeltro-postgres, um zeltro-mariadb, um zeltro-redis, um zeltro-mongo e um zeltro-memcached, compartilhados por todos os projetos Zeltro da máquina. Rode dez projetos e você continua tendo no máximo um de cada.

• Os projetos se comunicam pelo nome. Todos os projetos entram em uma mesma rede Docker e são resolvidos pelo nome dentro dela, então um contêiner pode fazer fetch('http://my-api/') ou psql -h zeltro-postgres sem nenhuma configuração de rede.
• Sem roleta de portas. Você nunca escolhe uma porta. Cada projeto recebe o próprio endereço quando é criado, e o zeltro status mostra qual é — nada de localhost:3001 vs :3002 vs :3003, nada de gambiarra com host.docker.internal.
• Consolidação de recursos. Sete contêineres Postgres duplicados consumindo ~700MB viram um só consumindo ~100MB.
• Sem conflitos. Quando o arquivo compose do próprio projeto já traz um banco de dados ou cache (Postgres na 5432, MySQL na 3306, Redis e assim por diante), o Zeltro remove esse serviço e aponta o app para o compartilhado.

Runtimes já prontos#

Três imagens base cobrem todas as stacks suportadas: PHP 8.3, Python 3 e Node 22. Cada uma roda o nginx sob o supervisor.

Você nunca precisa caçar uma imagem, comparar tags ou escrever um Dockerfile. A imagem PHP já vem com as extensões de MySQL, PostgreSQL, SQLite, Redis e MongoDB compiladas. A imagem Python traz os drivers dos cinco, além de Django, Flask, FastAPI, gunicorn e uvicorn. A imagem Node traz as ferramentas de build que o npm precisa para drivers nativos.

Veja em Arquitetura o que cada imagem inclui.

Feito para agentes de IA trabalharem dentro dele#

Sem supervisão, um agente de IA monta um projeto do jeito que quiser — com as próprias portas, o próprio banco de dados embutido, o próprio arquivo compose — sem se importar com os outros doze projetos da sua máquina. O Zeltro dá ao agente um ambiente fixo para trabalhar:

• Uma plataforma estável. Serviços compartilhados, uma única rede, endereços atribuídos e imagens de runtime conhecidas fazem o agente construir o seu app em vez de reinventar a infraestrutura.
• Menos tokens. A estrutura inicial dos frameworks, a rede, a geração de segredos e mais de 200 instalações de apps já vêm prontas. O agente não precisa redescobrir a cada sessão como ligar nginx + php-fpm.
• Contexto que permanece. Quando o Zeltro entrega um projeto ao seu agente de IA, ele escreve um AGENTS.md que descreve o endereço, o banco de dados e os comandos do projeto, para que uma nova sessão do agente possa assumir o projeto do zero.

Por onde continuar#

Quando o Zeltro não acrescenta muito#

Se você roda exatamente um projeto e nunca mexe em outro, um simples docker compose up resolve. O Zeltro mostra seu valor quando você tem vários projetos, ou um agente de IA, dividindo a mesma máquina.

Achou um erro nesta tradução? Avise a gente no GitHub.