Processos em poucas teclas
Os aliases do Desktop cobrem o dia a dia do PM2: iniciar, acompanhar, controlar e manter os processos depois do boot.
Iniciar
Suba os apps do arquivo ecosystem ou abra o PM2.
p-startinicia os apps do ~/ecosystem.config.jspabre o PM2
Acompanhar
Veja a lista, o consumo e os logs.
pllista os processospmonabre o painel de CPU e memóriaplogsegue os logs de todos os processos
Controlar
Pare, reinicie ou remova um processo.
pstop id-ou-nomepara um processoprestart id-ou-nomereinicia um processopdel id-ou-nomeremove um processo da lista
Manter no boot
Grave a lista e restaure quando precisar.
psavegrava a lista de processos para o próximo bootpresrestaura a lista gravada
Estado dos processos
No Desktop, você usa pl para executar pm2 list. O instalador inicia o app, mas você deve consultar o resultado no seu ambiente em vez de presumir que ele permaneceu ativo.
Logs dos processos
O alias plog executa pm2 logs. O Desktop também define agl-logs como pm2 logs agentlytics. O fluxo de instalação não instala pm2-logrotate.
Alias de monitoramento
Você usa pmon para executar pm2 monit no Desktop. O alias fica nos arquivos Zsh de macOS e Linux. A camada Omarchy não cria esse mesmo alias.
O Agentlytics roda pelo PM2
Você recebe uma configuração PM2 com um app chamado agentlytics. No Desktop, o instalador baixa esse arquivo, inicia o app e executa pm2 save.
Agentlytics pelo PM2
O app usa script: "npx" e args: "agentlytics", com uma instância, modo fork, watch: false e autorestart: true. Você recebe os aliases agl-start, agl-stop, agl-restart, agl-logs e agl-show no Zsh do Desktop.
agl-startagl-stopagl-restartagl-logsagl-show
| Opção | Valor |
|---|---|
script | "npx" |
args | "agentlytics" |
instances | 1 |
exec_mode | "fork" |
watch | false |
autorestart | true |
max_memory_restart | "200M" |
Arquivo ecosystem
O arquivo fornecido tem apenas Agentlytics. No Desktop, p-start, p-stop e p-restart usam ~/ecosystem.config.js. Na Omarchy, a cópia fica em ~/.setupvibe/ecosystem.config.js e não é iniciada pelo instalador.
Opção de reinício
O app Agentlytics tem autorestart: true no arquivo ecosystem. Você pode conferir essa opção no arquivo baixado. O SetupVibe não altera o código do Agentlytics para corrigir falhas da aplicação.
Limite de memória
O arquivo ecosystem define max_memory_restart: "200M" para o Agentlytics. Esse é o valor configurado. Você pode revisá-lo antes de iniciar o app.
Modo de execução do Agentlytics
O Agentlytics usa exec_mode: "fork" e instances: 1. O SetupVibe não configura um app em modo cluster nesse arquivo.
Processos depois do boot
O Desktop grava a lista de processos e prepara a inicialização com o sistema.
O que o SetupVibe configura
No Desktop, o script instala PM2 pelo npm. Na etapa final, executa pm2 set pm2:autodump true, define pm2:log_date_format como YYYY-MM-DD HH:mm:ss, baixa o arquivo ecosystem, inicia seus apps e executa pm2 save.
Inicialização com o sistema
No Linux e no WSL com systemd ativo, o Desktop configura o serviço pm2-<usuário>. No macOS, cria o LaunchAgent pm2.<usuário> na sessão gráfica. No macOS, você precisa entrar nessa sessão para carregar o LaunchAgent após reiniciar a máquina.
No Linux, o script também grava 10-setupvibe-path.conf na pasta de ajustes do serviço para definir o PATH.
Inicialização após reiniciar
O Desktop executa pm2 save após iniciar o arquivo ecosystem. O LaunchAgent do macOS usa pm2 resurrect ao carregar a sessão gráfica. No Linux, o script configura startup com systemd. Você precisa conferir o serviço e os processos depois de reiniciar a máquina.
Conferir o ambiente
Você pode consultar pl e agl-logs no Desktop. No Linux, confira o serviço pm2-<usuário> usando o nome do usuário-alvo da instalação. Ele pode diferir do usuário da sessão de consulta.
PM2 em cada edição
O Desktop instala PM2 pelo npm, prepara a inicialização e inicia Agentlytics pelo arquivo ~/ecosystem.config.js. No Linux, usa systemd. No macOS, usa um LaunchAgent da sessão gráfica. Na Omarchy, o SetupVibe instala PM2 e Agentlytics, mas não inicia o app nem configura startup. Server e Windows não instalam PM2.
Para uma VPS de desenvolvimento, Vibe Coding ou agentes remotos, você usa a edição Desktop. A edição Server atende máquinas que executam aplicações em produção.
