Processos em background
Quando o agente precisa subir um servidor de desenvolvimento, um watcher ou qualquer processo que não termina sozinho, ele usa processos em background — o processo roda continuamente enquanto a sessão está ativa.
Como funciona
O agente usa run_background para iniciar processos longos e retorna imediatamente sem bloquear o chat. O processo continua rodando em paralelo.
Fluxo típico:
- Agente verifica se a porta está livre
- Inicia o servidor em background (
npm run dev,uvicorn, etc.) - Aguarda alguns segundos e lê os logs para confirmar que subiu
- Informa a URL onde o servidor está rodando
- Continua a conversa normalmente
Painel de processos
No chat, um painel lateral mostra todos os processos ativos:
- Comando que está rodando
- Status: rodando ✅ ou encerrado ❌
- Logs em tempo real: clique para expandir a saída
Gerenciando processos
Via chat (recomendado)
Suba o servidor de desenvolvimento
Verifique os logs do servidor
Pare o servidor
Via terminal integrado
Você também pode interagir com processos iniciados pelo agente através do terminal.
Tipos de processos suportados
| Categoria | Exemplos |
|---|---|
| Servidores JS | npm run dev, vite, next dev, nodemon |
| Servidores Python | uvicorn main:app, flask run, gunicorn |
| Java/JVM | java -jar app.jar, ./gradlew bootRun |
| Watchers | tsc --watch, webpack --watch |
| Docker | docker compose up |
Ciclo de vida
Processos em background são vinculados à sessão do chat. Se você fechar o chat e reabrir a mesma sessão, os processos iniciados anteriormente podem ainda estar rodando — o painel os exibe com o status atualizado.
Cancelar a geração do chat não para processos já iniciados. Para encerrar um processo, use o botão de parar no painel ou peça ao agente para encerrá-lo.