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 
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  --online
halo theme upgrade --all --online --yes
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.
• 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 
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 
halo plugin disable  --force
halo plugin upgrade 
halo plugin upgrade  --online
halo plugin upgrade --all --online --yes
halo plugin uninstall  --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 
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 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  --output ./backup.zip
halo backup delete  --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 
halo moment create --content "Hello from Halo CLI"
halo moment create --content "Hello Halo" --visible PUBLIC --tags life,cli --approved true
halo moment update  --content "Updated content"
halo moment update  --visible PRIVATE --tags updated
halo moment delete  --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 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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: halo-dev
• Source: halo-dev/cli
• License: MIT
• Homepage: https://www.npmjs.com/package/@halo-dev/cli

Install and usage instructions live in the source repository linked above.