Uso Rápido (sem instalar)

Execute diretamente com npx, sem necessidade de instalação:

npx (recomendado)

npx @bforgeio/piunter

Verificar

npx @bforgeio/piunter --version

Requisitos

  • Node.js 18.0.0+
  • Linux (Debian, Ubuntu, Arch, Fedora)

Instalação Global (opcional)

Se preferir instalar permanentemente:

npm

npm install -g @bforgeio/piunter

yarn

yarn global add @bforgeio/piunter

pnpm

pnpm add -g @bforgeio/piunter

Uso

Interativo

npx @bforgeio/piunter

Flags

npx @bforgeio/piunter --npm
npx @bforgeio/piunter --all
npx @bforgeio/piunter --analyze

Dry-run

npx @bforgeio/piunter --all --dry-run

Forçar

npx @bforgeio/piunter --all --force

Módulos

Pacotes

Remove pacotes órfãos do sistema.

--packages

NPM

Limpa cache e packages órfãos.

--npm

Yarn

Limpa cache e node_modules órfãos.

--yarn

PNPM

Limpa store e links órfãos.

--pnpm

Cache

Limpa ~/.cache do usuário.

--cache

Flatpak

Remove dados órfãos do Flatpak.

--flatpak

Snap

Remove revisões antigas do Snap.

--snap

Docker

Remove containers e imagens não usados.

--docker

Logs

Limpa logs via journalctl.

--logs

Large Files

Encontra e remove arquivos grandes.

--large-files

AppImage

Gerencia AppImages.

--appimage

Thumbs

Remove miniaturas em cache.

--thumbs

Recent

Limpa lista de arquivos recentes.

--recent

Analyze

Analisa uso de disco.

--analyze

Flags

FlagDescrição
--allExecuta todos os módulos
--analyzeAnalisa sem limpar
--dry-runSimula execução
--forcePula confirmações
--configArquivo de configuração
--thresholdTamanho mínimo (MB)
--verboseModo verboso
--quietModo silencioso

Configuração

Arquivo ~/.piunter.json:

{
  "threshold": 100,
  "modules": {
    "npm": true,
    "cache": true,
    "logs": true
  },
  "options": {
    "dryRun": false,
    "force": false
  }
}

Comandos

npx @bforgeio/piunter config init
npx @bforgeio/piunter config set threshold 500
npx @bforgeio/piunter config show

Plugins

import { Plugin, PluginContext } from '@bforgeio/piunter';

export default class MeuPlugin implements Plugin {
  name = 'meu-plugin';
  
  async execute(context: PluginContext): Promise {
    const { logger, dryRun } = context;
    logger.info('Executando...');
    if (dryRun) return;
    logger.success('Concluído!');
  }
}
npx @bforgeio/piunter plugin add ./caminho
npx @bforgeio/piunter plugin list
npx @bforgeio/piunter plugin remove meu-plugin

FAQ

É seguro?

Sim. Use --dry-run para visualizar o impacto antes de executar.

Quais distribuições?

Debian/Ubuntu (APT), Arch/Manjaro (Pacman), Fedora/RHEL (DNF).

Automatizar via cron? 
0 3 * * 0 npx @bforgeio/piunter --all --force --quiet
Desinstalar 
npm uninstall -g @bforgeio/piunter
É seguro usar?

Sim! O piunter:

  • Nunca executa sem confirmação (exceto com --force)
  • Oferece modo --dry-run para simular
  • Verifica comandos antes de executar
  • Limpa senhas sudo da memória ao encerrar
  • Processa pacotes de forma segura (sem command injection)