mac-cleaner-cli has right arrow using @inquirer/checkbox which doesn't support it

[jbrva]

Mac Cleaner CLI version

1.3.1

macOS version

Tahoe

Node.js version

v25.8.2

What happened?

Right arrow does not work without --file-picker

Steps to reproduce

cat ~/.npm-global/lib/node_modules/mac-cleaner-cli/package.json | grep -A 20 '"dependencies"'
"dependencies": {
"@inquirer/checkbox": "^5.0.2",
"@inquirer/confirm": "^6.0.2",
"chalk": "^5.3.0",
"commander": "^14.0.2",
"ora": "^9.0.0"
},
"os": [
"darwin"
],
"engines": {
"node": ">=20.12.0"
}

Expected behavior

@inquirer/checkbox

Doesn't support right arrow natively. Up/down to navigate, space to select, enter to confirm.

Error output / logs

Checklist

• I searched existing issues and this hasn't been reported before
• I'm using the latest version

[guhcostan]

Obrigado por reportar! Confirmado — o @inquirer/checkbox não suporta navegação com a seta direita nativamente. As teclas suportadas são: ↑/↓ para navegar, space para selecionar/deselecionar e enter para confirmar.

Algumas possíveis soluções a considerar:

1. Documentação: Adicionar as teclas disponíveis na mensagem de instrução do prompt para que o usuário saiba o que esperar
2. Alternativa de componente: Avaliar o uso de @inquirer/select encadeado ou um componente customizado que suporte seta direita para expandir categorias
3. Keybinding customizado: Investigar se é possível estender o @inquirer/checkbox com keybindings customizados via a API de extensão do Inquirer v9+

Enquanto isso, a navegação funciona corretamente com ↑/↓ + space + enter.

---

Generated by Claude Code

[jbrva]

I tried adding this to .maccleanerrc, but it didn't want to take. does the config file support it?

{
  "filePicker": true,

[guhcostan]

@jbrva Boa pergunta! Sim, o .maccleanerrc suporta "filePicker": true — ele mapeia diretamente para a flag --file-picker do CLI. O formato correto do arquivo é:

{
  "filePicker": true
}

Certifique-se de que o arquivo está na pasta raiz do seu home (~/.maccleanerrc) e que o JSON está válido (sem vírgula pendente no último campo). Se ainda não funcionar, pode confirmar rodando mac-cleaner-cli --file-picker diretamente para verificar se o comportamento esperado ocorre via flag, e depois testar novamente via config.

---

Generated by Claude Code

[guhcostan]

@jbrva conseguiu resolver usando o "filePicker": true no .maccleanerrc? Se sim, o workaround está funcional pelo config — mas vamos manter a issue aberta para rastrear uma possível melhoria de UX (como exibir as teclas disponíveis no prompt ou investigar suporte a keybindings customizados no @inquirer/checkbox).

Se o arquivo de config funcionou pra você, fique à vontade pra comentar aqui para atualizar o status.

---

Generated by Claude Code

[jbrva]

@jbrva conseguiu resolver usando o "filePicker": true no .maccleanerrc? Se sim, o workaround está funcional pelo config — mas vamos manter a issue aberta para rastrear uma possível melhoria de UX (como exibir as teclas disponíveis no prompt ou investigar suporte a keybindings customizados no @inquirer/checkbox).

Se o arquivo de config funcionou pra você, fique à vontade pra comentar aqui para atualizar o status.

---

Generated by Claude Code

I used the file it generated, but it doesn't see filepicker when I add to the file. I can try again from scratch. Thanks.

[jbrva]

Started fresh:

mac-cleaner-cli config --init
Created configuration file at: /Users/myusername/.maccleanerrc

Edited the file:

cat .maccleanerrc
{
  "filePicker": true,
  "downloadsDaysOld": 30,
  "largeFilesMinSize": 524288000,
  "backupEnabled": false,
  "backupRetentionDays": 7,
  "parallelScans": true,
  "concurrency": 4,
  "extraPaths": {
    "nodeModules": [
      "~/Projects",
      "~/Developer",
      "~/Code"
    ],
    "projects": [
      "~/Projects",
      "~/Developer",
      "~/Code"
    ]
  }
}

Ran the command:

 mac-cleaner-cli config --show
{
  "downloadsDaysOld": 30,
  "largeFilesMinSize": 524288000,
  "backupEnabled": false,
  "backupRetentionDays": 7,
  "parallelScans": true,
  "concurrency": 4,
  "extraPaths": {
    "nodeModules": [
      "/Users/myusername/Projects",
      "/Users/myusername/Developer",
      "/Users/myusername/Code"
    ],
    "projects": [
      "/Users/myusername/Projects",
      "/Users/myusername/Developer",
      "/Users/myusername/Code"
    ]
  }
}

Either I did not format the file correctly, it is making a config file in one place and expecting it elsewhere, or it is not checking for filepicker boolean correctly.

[guhcostan]

@jbrva Bug confirmado — e peço desculpas pelos comentários anteriores incorretos. O filePicker: true no .maccleanerrc não funciona e nunca funcionou. Aqui está o motivo:

O campo filePicker não está definido na interface Config em src/utils/config.ts e nem é tratado pelo validateConfig. Isso significa que ao carregar o arquivo de config, o campo é silenciosamente descartado — por isso o config --show não o exibe.

O fix envolve três mudanças:

1. Adicionar filePicker?: boolean à interface Config
2. Tratar o campo em validateConfig
3. Fazer interactiveCommand ler o valor do config quando a flag --file-picker não for passada via CLI

Isso será corrigido em uma próxima versão. Enquanto isso, a única forma de usar o file picker é via flag direta: mac-cleaner-cli --file-picker.

---

Generated by Claude Code

[guhcostan]

@jbrva The filePicker: true config bug is now fixed in branch claude/inspiring-pasteur-OPpJN. Here's what was wrong and what changed:

Root cause: filePicker was missing from the Config interface in src/utils/config.ts, so it was silently dropped during validateConfig — exactly why config --show never displayed it.

Changes made:

1. Added filePicker?: boolean to the Config interface
2. Added validation in validateConfig to accept the boolean value
3. Updated src/index.ts to load the config on startup and use config.filePicker as a fallback when --file-picker is not passed on the CLI

Once this is merged and a new release is published, "filePicker": true in your ~/.maccleanerrc will work as expected — no need to pass --file-picker on every run.

In the meantime, mac-cleaner-cli --file-picker remains the workaround.

---

Generated by Claude Code

[guhcostan]

This has been fixed and merged into main via #55.

What changed:

• filePicker?: boolean added to the Config interface in src/utils/config.ts
• filePicker is now validated in validateConfig, so it's no longer silently dropped
• src/index.ts now loads the config at startup and uses config.filePicker as a fallback when --file-picker is not passed on the CLI

Setting "filePicker": true in your ~/.maccleanerrc will work as expected once the next release is published. Thanks for the detailed reproduction steps — they were key to pinpointing the exact root cause!

---

Generated by Claude Code