halo-cli-operations

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 <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 <name> --online
halo theme upgrade --all --online --yes
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.
• App Store upgrades use --online. upgrade --all --online --yes upgrades all themes from the App Store without prompting.

Plugins

halo plugin list
halo plugin get <name>
halo plugin install --file ./plugin.jar
halo plugin install --url https://example.com/plugin.jar
halo plugin install --app-id app-SnwWD
halo plugin enable <name>
halo plugin disable <name> --force
halo plugin upgrade <name>
halo plugin upgrade <name> --online
halo plugin upgrade --all --online --yes
halo plugin uninstall <name> --force

Rules:

• Install from the Halo App Store with --app-id.
• App Store upgrades use --online. upgrade --all --online --yes upgrades all plugins from the App Store without prompting.
• 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 <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

halo backup list
halo backup get <name>
halo backup create
halo backup create my-backup
halo backup create --wait
halo backup create --wait --wait-timeout 300
halo backup create --format zip --expires-at "2026-12-31T23:59:59Z"
halo backup download <name> --output ./backup.zip
halo backup delete <name> --force

Rules:

• backup create [name] accepts an optional backup name.
• backup create --wait polls until completion or timeout.
• --format sets the backup format (default: zip).
• --expires-at sets an expiration time in ISO-8601 format.

Moments

halo moment list
halo moment get <name>
halo moment create --content "Hello from Halo CLI"
halo moment create --content "<p>Hello Halo</p>" --visible PUBLIC --tags life,cli --approved true
halo moment update <name> --content "Updated content"
halo moment update <name> --visible PRIVATE --tags updated
halo moment delete <name> --force

Rules:

• --visible accepts PUBLIC or PRIVATE.
• --tags is comma-separated.
• --release-time accepts ISO-8601 datetime.
• --approved accepts true or false.

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.