# 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'.

- Skill: `halo-dev/halo-cli-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add halo-dev/halo-cli-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/halo-dev/halo-cli-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: halo-dev (https://skillmd.com/u/halo-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/halo-dev/halo-cli-search

---


# 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

```bash
halo search --help
```

## Common Flows

Search with a direct public site URL:

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

Search with the active or selected profile:

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

Limit results and emit JSON:

```bash
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.