/install halo-cli-shared
Halo CLI Shared
Start here when the task says "use Halo CLI" but does not yet say whether it is auth, content, search, operations, or moderation.
Install And Verify
Install globally:
npm install -g @halo-dev/cli
Binary name:
halo
Check version and top-level help:
halo --version
halo --help
Top-Level Areas
authpostsingle-pagesearchpluginthemeattachmentbackupmomentcommentnotification
Shared Rules
- Most command areas require an authenticated profile.
- Use
halo auth loginto create a profile. - Use
--profile \x3Cname>when more than one profile exists. - Use
--jsonwhen output is meant for automation or follow-up parsing. - In non-interactive mode, dangerous commands usually require
--force. - Read
--helpbefore guessing flags for a specific command.
Public vs Authenticated
Most areas require auth.
The main public workflow is halo search, which can use a direct site URL without login:
halo search --keyword "halo" --url https://www.halo.run
Config And Secrets
Profile metadata is stored in:
$HALO_CLI_CONFIG_DIR/config.jsonifHALO_CLI_CONFIG_DIRis set- otherwise
$XDG_CONFIG_HOME/halo/config.json - otherwise
~/.config/halo/config.json
Credentials are stored in the system keyring.
Routing
- Use
halo-cli-authfor login, current profile, profile list/use/delete, and credential repair. - Use
halo-cli-contentfor posts and single pages. - Use
halo-cli-searchfor public site search. - Use
halo-cli-operationsfor themes, plugins, attachments, backups, and moments. - Use
halo-cli-moderation-notificationsfor comments, replies, and notifications.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install halo-cli-shared - After installation, invoke the skill by name or use
/halo-cli-shared - Provide required inputs per the skill's parameter spec and get structured output
What is Halo Cli Shared?
Use when a task broadly involves Halo CLI and the correct command area is not yet clear, or when you need shared rules for profiles, JSON output, help discov... It is an AI Agent Skill for Claude Code / OpenClaw, with 192 downloads so far.
How do I install Halo Cli Shared?
Run "/install halo-cli-shared" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Halo Cli Shared free?
Yes, Halo Cli Shared is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Halo Cli Shared support?
Halo Cli Shared is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Halo Cli Shared?
It is built and maintained by Ryan Wang (@ruibaby); the current version is v0.1.1.