Halo CLI Search

Use when searching public content on a Halo site with Halo CLI. This includes keyword search, site URL based search, result limits, or any search that does not require authenticated console access. Trigger this skill whenever the user wants to search a Halo site from the terminal, even if they do not explicitly mention 'search'.

halo-dev 2b654a1 1.4 KB Updated

File contents

Halo CLI Search

Use this skill for halo search.

This is the main Halo CLI workflow that can run without authenticated console access when --url is provided.

Command

halo search --help

Common Flows

Search with a direct public site URL:

halo search --keyword "halo" --url https://www.halo.run

Search with the active or selected profile:

halo search --keyword "release notes"
halo search --keyword "release notes" --profile production

Limit results and emit JSON:

halo search --keyword "plugin" --limit 5 --json

Rules

  • --keyword is required.
  • --limit must be a positive number.
  • --url targets a public Halo site directly and avoids authenticated console access.
  • If --url is omitted, Halo CLI resolves the base URL from the active or selected profile.
  • Use --json when another tool needs to parse search results.

Related Skills

  • Use halo-cli-auth if the task first needs a profile.
  • Use halo-cli-content after search when the goal shifts to editing posts or pages.

halo-dev/cli/tree/main/skills/halo-cli-search commit 2b654a10bb

Frequently asked questions

npx skillmds@latest add halo-dev/halo-cli-search