halo-cli-auth
Use when working with Halo CLI authentication, login, bearer token or basic auth, profile setup, profile switching, current profile inspection, or fixing missing keyring credentials. Trigger this skill whenever the user needs to log into Halo, manage Halo CLI profiles, switch profiles, or diagnose authentication issues.
How do I install this agent skill?
npx skills add https://github.com/halo-dev/cli --skill halo-cli-authIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides standard instructions and command templates for using the Halo CLI authentication features. It follows security best practices by using placeholders for sensitive data and recommending the use of system keyrings for secret storage.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Halo CLI Auth
Use this skill for halo auth and halo auth profile.
If authentication is not set up yet, do this first before running post, single-page, plugin, theme, attachment, backup, moment, comment, or notification commands.
Commands
halo auth --help
halo auth login --help
halo auth profile --help
Main workflows:
halo auth loginhalo auth currenthalo auth profile listhalo auth profile currenthalo auth profile get <name>halo auth profile use <name>halo auth profile delete <name>halo auth profile doctor
Common Flows
Login with bearer token:
halo auth login \
--profile local \
--url http://127.0.0.1:8090 \
--auth-type bearer \
--token <token>
Login with basic auth:
halo auth login \
--profile local \
--url http://127.0.0.1:8090 \
--auth-type basic \
--username admin \
--password <password>
Inspect and switch profiles:
halo auth current
halo auth profile list
halo auth profile use production
halo auth profile get production --json
Diagnose broken credentials:
halo auth profile doctor
halo auth profile delete production --force
halo auth login --profile production --url https://halo.example.com --auth-type bearer --token <token>
Rules
- In non-interactive mode,
halo auth loginrequires--profile,--url, and--auth-type. basicauth requires--usernameand--password.bearerauth requires--token.- Use
--jsonwhen another tool needs structured output. profile deleteis destructive; use--forcein non-interactive mode.- Profile metadata lives in config, but secrets live in the system keyring.
Routing
- 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/halo-dev/cli/halo-cli-auth">View halo-cli-auth on skillZs</a>