O que cli-anything-pm2 faz?
Uma interface de linha de comando sem estado para gestão de processos PM2. Comunica-se através do subprocesso PM2 CLI. Sem estado local ou sessão.
Instalação
pip install -e .
Pré-requisitos:
- Python 3.10+
- PM2 instalado globalmente (
npm install -g pm2)
Uso
Comandos Básicos
# Mostrar ajuda
cli-anything-pm2 --help
# Iniciar modo REPL interativo
cli-anything-pm2
# Executar com saída JSON (para consumo por agentes)
cli-anything-pm2 --json process list
cli-anything-pm2 --json system version
Modo REPL
Quando invocado sem um subcomando, a CLI entra em uma sessão REPL interativa:
cli-anything-pm2
# Digite comandos interativamente com autocompletar e histórico
Grupos de Comandos
process
Comandos de inspeção de processos.
| Comando | Descrição |
|---|---|
list | Listar todos os processos PM2 |
describe <nome> | Obter informações detalhadas de um processo |
metrics | Obter métricas de todos os processos |
lifecycle
Comandos de ciclo de vida de processos.
| Comando | Descrição |
|---|---|
start <script> --name <nome> | Iniciar um novo processo |
stop <nome> | Parar um processo |
restart <nome> | Reiniciar um processo |
delete <nome> | Excluir um processo |
logs
Comandos de gestão de logs.
| Comando | Descrição |
|---|---|
view <nome> --lines 50 | Visualizar logs recentes |
flush [nome] | Limpar logs |
system
Comandos de nível de sistema.
| Comando | Descrição |
|---|---|
save | Salvar a lista atual de processos |
startup | Gerar script de inicialização |
version | Obter a versão do PM2 |
Formatos de Saída
Todos os comandos suportam dois modos de saída:
- Legível por humanos (padrão): Tabelas, cores, texto formatado
- Legível por máquina (flag
--json): JSON estruturado para consumo por agentes
# Saída humana
cli-anything-pm2 process list
# Saída JSON para agentes
cli-anything-pm2 --json process list
Para Agentes de IA
Ao usar esta CLI programaticamente:
- Sempre use a flag
--jsonpara saída analisável - Verifique os códigos de retorno - 0 para sucesso, diferente de zero para erros
- Analise o stderr para mensagens de erro em caso de falha
Versão
1.0.0