Semáforo EnvO hub do seu ambiente local. Troque bancos e APIs do Instalar pelo VS Code Marketplace · ou no VS Code: Ctrl+Shift+X → pesquise
O que ele resolve
Começando em 2 minutos
Perfis do
|
| Marcador | Significado |
|---|---|
# @group <Nome> |
Abre um grupo |
# @option <nome> |
Abre uma opção dentro do grupo |
# @option <nome> @danger |
Opção remota: pede confirmação e deixa o semáforo vermelho |
# @end |
Fecha o grupo |
- Só linhas
CHAVE=valor(ativas) e# CHAVE=valor(inativas) são alternadas. Comentários comuns e tudo que está fora dos grupos ficam intactos. - Uma opção pode ter várias variáveis (ex.:
DATABASE_URL+DIRECT_URL, ouHOST,PORT,USER...). - Se o arquivo tiver erro de sintaxe, a extensão mostra a linha e não altera nada.
- Ctrl+Z desfaz qualquer troca.
Organizar sem escrever marcador nenhum
- Organizar .env automaticamente: o Semáforo nomeia as opções pelo endereço (
localhostvira local,*.supabase.comvira supabase, um host com "homolog" vira homolog...) ou por um comentário curto logo acima da linha (#Homolog). Tudo que não aponta pra máquina local é marcado como@danger, e variáveis que mudam juntas (ex.:DATABASE_URLeDIRECT_URLno mesmo host) entram na mesma opção. - Criar grupo com as linhas selecionadas: selecione as linhas no editor → botão direito → Semáforo: Criar grupo com as linhas selecionadas.
Nos dois casos, você vê um diff com o antes e depois e só aplica se aprovar.
Serviços
O painel Serviços mostra cada front e back com um semáforo próprio:
| Bolinha | Estado |
|---|---|
| 🟢 | Rodando (a porta respondeu) |
| 🟡 | Iniciando |
| ⚪ | Parado |
| 🔴 | Caiu (o processo terminou com erro) |
- ▶ ■ ⟳ por serviço, ▶ por sistema (sobe o back antes do front) e Iniciar/Parar todos no topo.
- Cada serviço roda no próprio terminal visível (
sgc · back,sgc · front...). Clique no serviço pra ver os logs. - Reinício certeiro: ao trocar um
.env, só reiniciam os serviços que rodam na pasta daquele.env. O front não reinicia quando você troca o banco do back. - Dependências: se uma opção ativa aponta pra
localhost:PORTAe o serviço daquela porta está parado, o painel avisa e oferece Iniciar. - Adota o que você já roda: se você mesmo rodar
npm run devnum terminal, na pasta de um serviço configurado, o painel reconhece e passa a controlar aquele terminal. - Porta ocupada: antes de iniciar, o Semáforo avisa se a porta já está em uso por outro processo.
Vários sistemas juntos (ecossistema)
Pra testar sistemas que conversam entre si (ex.: Controle, SGC e Oráculo, cada um com front e back), abra todos numa janela só com um workspace de várias pastas:
- No painel Serviços (menu ⋯), use Criar workspace do ecossistema e escolha as pastas dos sistemas.
- Abra o workspace criado.
- Clique em Detectar serviços.
Cada sistema passa a ter o seu .env no painel Perfis, e a status bar resume todos (ex.: sgc: homolog · controle · oraculo). Os serviços ficam salvos no próprio arquivo .code-workspace, então dá pra versionar e a equipe inteira ganha o mesmo painel:
{
"folders": [{ "path": "controle" }, { "path": "sgc" }, { "path": "oraculo" }],
"settings": {
"semaforoEnv.services": [
{ "system": "sgc", "name": "back", "folder": "sgc", "cwd": "sgc-api", "command": "npm run start:dev", "port": 3000 },
{ "system": "sgc", "name": "front", "folder": "sgc", "cwd": "sgc-web", "command": "npm run dev", "port": 5174 }
]
}
}
Proteções
- Status bar como semáforo: verde quando tudo é local, amarela quando algum grupo está inconsistente, vermelha quando há opção
@dangerativa. - Freio de mão: com uma opção
@dangerativa,prisma migrate dev/deploy/reset,prisma db push/seede equivalentes de TypeORM, Sequelize e Knex são cancelados no terminal integrado. Você escolhe entre Rodar mesmo assim e Voltar tudo pra local. - Aviso ao abrir: se o projeto abrir com opção remota ativa, o Semáforo avisa e volta tudo pra local com um clique.
- 🏠 Voltar tudo pra local: leva todos os grupos de todos os sistemas pra opção segura e reinicia o que for preciso.
Projeto com um servidor só
Sem o painel de serviços configurado, ainda dá pra reiniciar o servidor sozinho: Ctrl+Shift+P → Semáforo Env: Configurar reinício automático. O Semáforo reinicia o terminal onde o servidor está rodando (o seu) ou abre um terminal visível. Também funciona com tasks do VS Code e com a sessão de debug (F5).
Configurações
| Setting | Padrão | Descrição |
|---|---|---|
semaforoEnv.file |
.env |
.env controlado, relativo à pasta. Em workspaces de várias pastas, cada sistema tem o seu |
semaforoEnv.services |
[] |
Serviços do painel: system, name, folder, cwd, command, port |
semaforoEnv.restart.mode |
off |
Reinício simples: terminal, task, debug ou off |
semaforoEnv.restart.command |
Comando do servidor no reinício simples | |
semaforoEnv.restart.cwd |
Pasta usada quando é preciso abrir um terminal novo | |
semaforoEnv.restart.task |
Task usada no modo task |
|
semaforoEnv.showRestartHint |
true |
Lembrete pra reiniciar quando nada está configurado |
semaforoEnv.guard.enabled |
true |
Liga o freio de mão |
semaforoEnv.guard.patterns |
migrations comuns | Expressões regulares dos comandos barrados |
semaforoEnv.warnOnStartup |
true |
Aviso ao abrir com opção remota ativa |
Segurança
- Nenhuma requisição pra internet. A única verificação de rede é se uma porta em localhost está respondendo, pra saber se o serviço subiu.
- Nunca exibe nem registra valores de variáveis, só nomes de grupos, opções, chaves e portas.
- O freio de mão só lê a linha de comando digitada no terminal integrado. Nada é gravado.
- Não versione o
.envreal. Versione um.env.examplecom os marcadores e valores falsos.
Limitações conhecidas
- O freio de mão e a adoção de terminais dependem da integração de shell do VS Code (ativa por padrão no PowerShell, bash e zsh), e só enxergam o terminal integrado.
- O reinício certeiro considera que o serviço lê o
.envda pasta onde ele roda (o comportamento padrão dodotenve do NestJS). - Requer VS Code 1.93 ou mais recente.
Desenvolvimento
npm install
npm test # compila e roda os testes
npm run package # gera o .vsix
F5 abre uma janela de teste já na pasta sandbox/.
Licença
MIT · feito por Arabella Dev
