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:

CODEBLOCK0

Binary name:

CODEBLOCK1

Check version and top-level help:

CODEBLOCK2

Top-Level Areas

• - INLINECODE0
• INLINECODE1
• INLINECODE2
• INLINECODE3
• INLINECODE4
• INLINECODE5
• INLINECODE6
• INLINECODE7
• INLINECODE8
• INLINECODE9
• INLINECODE10

Shared Rules

• - Most command areas require an authenticated profile.
• Use halo auth login to create a profile.
• Use --profile <name> when more than one profile exists.
• Use --json when output is meant for automation or follow-up parsing.
• In non-interactive mode, dangerous commands usually require --force.
• Read --help before 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:

CODEBLOCK3

Config And Secrets

Profile metadata is stored in:

• - $HALO_CLI_CONFIG_DIR/config.json if HALO_CLI_CONFIG_DIR is set
• otherwise INLINECODE19
• otherwise INLINECODE20

Credentials are stored in the system keyring.

Routing

• - Use halo-cli-auth for login, current profile, profile list/use/delete, and credential repair.
• Use halo-cli-content for posts and single pages.
• Use halo-cli-search for public site search.
• Use halo-cli-operations for themes, plugins, attachments, backups, and moments.
• Use halo-cli-moderation-notifications for comments, replies, and notifications.