Maleta.dev
Open app

Search documentation

    / documentation

    Run the CLI

    Install the maleta CLI through npm, run its commands, and read the official help.

    #Prerequisite and installation

    The CLI declares Node >=20 as an engine requirement. This is advisory: there is no runtime version check.

    Install and show help
    bash
    npm install -g maleta.dev@latest
maleta --version
maleta --help

    To run it once without installing anything, use npx maleta.dev --help. Releases earlier than 0.2 do not include tray.

    #Help and commands

    maleta --help output
    text
    maleta - local Maleta selection CLI

Usage:
  maleta init [--file path]
  maleta validate [--file path]
  maleta install [--file path] [--tool all|claude|codex|agents] [--dry-run]
  maleta sync [--file path] [--tool all|claude|codex|agents] [--dry-run]
  maleta tray
  maleta --version

Device commands (optional account):
  maleta login [--name label]      autoriza este computador (código em app.maleta.dev/device)
  maleta logout                    revoga a credencial e para de seguir a Maleta
  maleta attach <maleta>           segue uma Maleta da conta neste computador
  maleta detach                    para de seguir a Maleta vinculada
  maleta status                    mostra o que este computador segue e o que ficou pendente
  maleta watch [--interval seconds] [--once]
                                   aplica as mudanças da Maleta vinculada (não remove nada)
  maleta prune [--dry-run] [--yes]  remove só os arquivos que a Maleta escreveu e não usa mais

maleta tray starts the maleta.dev tray icon in the background. It checks npm at startup and every 24 hours, then restarts after a verified update.
The file targetTool is used when --tool is omitted. targetOs must match the local host.
GitHub skills are resolved from the declared public repository/path/ref without executing repository content.

    With no arguments, or with --help or -h, the CLI prints this help and exits with code 0. The default file is maleta.json; use --file <path> to specify another path.