halo-cli-operations

# Halo CLI Operations Use this skill for `halo theme`, `halo plugin`, `halo attachment`, `halo backup`, and `halo moment`. ## Commands ```bash halo theme --help halo plugin --help halo attachment --help halo backup --help halo moment --help ``` ## Themes ```bash halo theme list halo theme current halo theme get <name> halo theme install --file ./theme.zip halo theme install --url https://example.com/theme.zip halo theme activate <name> halo theme reload <name> halo theme upgrade <name> halo theme upgrade --all halo theme delete <name> --force ``` Rules: - `theme list` marks the active theme in table output. - Local theme install uses `--file`. - `theme install --url` and `theme upgrade --url` prompt for confirmation when the remote host is not `www.halo.run`; use `--yes` to bypass that prompt in automation or other non-interactive runs. - `upgrade --all` is for App Store-aware upgrades, not direct `--file` or `--url` sources. ## Plugins ```bash halo plugin list halo plugin get <name> halo plugin install --file ./plugin.jar halo plugin install --url https://example.com/plugin.jar halo plugin enable <name> halo plugin disable <name> --force halo plugin upgrade <name> halo plugin upgrade --all halo plugin uninstall <name> --force ``` Rules: - Plugin upgrades can use App Store-aware logic. - `plugin install --url` and `plugin upgrade --url` prompt for confirmation when the remote host is not `www.halo.run`; use `--yes` to bypass that prompt in automation or other non-interactive runs. - Treat `disable`, `upgrade`, and `uninstall` as mutating operations. ## Attachments ```bash halo attachment list halo attachment get <name> halo attachment upload --file ./image.png halo attachment upload --url https://example.com/image.png halo attachment download <name> --output ./downloads/image.png halo attachment delete <name> --force ``` Rules: - Use exactly one upload source: `--file` or `--url`. - Upload and download show progress in TTY mode unless `--json` is enabled. ## Backups ```bash halo backup list halo backup get <name> halo backup create halo backup create --wait halo backup create --wait --wait-timeout 300 halo backup download <name> --output ./backup.zip halo backup delete <name> --force ``` Rule: - `backup create --wait` polls until completion or timeout. ## Moments ```bash halo moment list halo moment get <name> halo moment create --content "Hello from Halo CLI" halo moment update <name> --content "Updated content" halo moment delete <name> --force ``` Useful options include `--visible`, `--tags`, and release-time related flags. ## Safety And Automation - Use `--profile <name>` for the intended environment. - Use `--json` when another tool needs structured output. - Use `--force` for destructive non-interactive actions. - Prefer `list` or `get` before batch or destructive maintenance.