Halo Cli Operations

---

name: halo-cli-operations version: 1.0.0 description: Use when operating Halo themes, plugins, attachments, backups, or moments from the terminal, including install, upgrade, activate, upload, download, create, delete, and batch maintenance flows. references: - ../halo-cli-shared metadata: openclaw: category: developer-tools requires: bins: ["halo"] cliHelp: "halo --help"

---

Halo CLI Operations

Use this skill for halo theme, halo plugin, halo attachment, halo backup, and halo moment.

Commands

halo theme --help
halo plugin --help
halo attachment --help
halo backup --help
halo moment --help

Themes

halo theme list
halo theme current
halo theme get 
halo theme install --file ./theme.zip
halo theme install --url https://example.com/theme.zip
halo theme activate 
halo theme reload 
halo theme upgrade 
halo theme upgrade --all
halo theme delete  --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

halo plugin list
halo plugin get 
halo plugin install --file ./plugin.jar
halo plugin install --url https://example.com/plugin.jar
halo plugin enable 
halo plugin disable  --force
halo plugin upgrade 
halo plugin upgrade --all
halo plugin uninstall  --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

halo attachment list
halo attachment get 
halo attachment upload --file ./image.png
halo attachment upload --url https://example.com/image.png
halo attachment download  --output ./downloads/image.png
halo attachment delete  --force

Rules:

Use exactly one upload source: --file or --url.

Upload and download show progress in TTY mode unless --json is enabled.

Backups

halo backup list
halo backup get 
halo backup create
halo backup create --wait
halo backup create --wait --wait-timeout 300
halo backup download  --output ./backup.zip
halo backup delete  --force

Rule:

backup create --wait polls until completion or timeout.

Moments

halo moment list
halo moment get 
halo moment create --content "Hello from Halo CLI"
halo moment update  --content "Updated content"
halo moment delete  --force

Useful options include --visible, --tags, and release-time related flags.

Safety And Automation

Use --profile 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.