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

- **Type:** Skill
- **Install:** `agentstack add skill-halo-dev-cli-halo-cli-search`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [halo-dev](https://agentstack.voostack.com/s/halo-dev)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [halo-dev](https://github.com/halo-dev)
- **Source:** https://github.com/halo-dev/cli/tree/main/skills/halo-cli-search
- **Website:** https://www.npmjs.com/package/@halo-dev/cli

## Install

```sh
agentstack add skill-halo-dev-cli-halo-cli-search
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [halo-dev](https://github.com/halo-dev)
- **Source:** [halo-dev/cli](https://github.com/halo-dev/cli)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/@halo-dev/cli

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-halo-dev-cli-halo-cli-search
- Seller: https://agentstack.voostack.com/s/halo-dev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.