halo-dev/cli

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.

First seen Mar 20, 2026

Installation

$ npx skills add halo-dev/cli --skill halo-cli-auth

Summary

  • 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from halo-dev/cli · top by installs.

npx skills add halo-dev/cli

Browse all from halo-dev/cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 29
License LICENSE
Default branch main
Open issues 2
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.0.0
Declared agents clawdbot
More metadata
openclaw
{"category":"developer-tools","requires":{"bins":["halo"]},"cliHelp":"halo auth --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,527 B
  • docs SUMMARY.md 342 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 81 installs

SKILL.md

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 login
  • halo auth current
  • halo auth profile list
  • halo auth profile current
  • halo 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 login requires --profile, --url, and --auth-type.
  • basic auth requires --username and --password.
  • bearer auth requires --token.
  • Use --json when another tool needs structured output.
  • profile delete is destructive; use --force in non-interactive mode.
  • Profile metadata lives in config, but secrets live in the system keyring.

Routing

  • 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.