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

- **Type:** Skill
- **Install:** `agentstack add skill-halo-dev-cli-halo-cli-auth`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [halo-dev](https://agentstack.voostack.com/s/halo-dev)
- **Installs:** 0
- **Category:** [Security](https://agentstack.voostack.com/c/security)
- **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-auth
- **Website:** https://www.npmjs.com/package/@halo-dev/cli

## Install

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

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

## About

# 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

```bash
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 `
- `halo auth profile use `
- `halo auth profile delete `
- `halo auth profile doctor`

## Common Flows

Login with bearer token:

```bash
halo auth login \
  --profile local \
  --url http://127.0.0.1:8090 \
  --auth-type bearer \
  --token 
```

Login with basic auth:

```bash
halo auth login \
  --profile local \
  --url http://127.0.0.1:8090 \
  --auth-type basic \
  --username admin \
  --password 
```

Inspect and switch profiles:

```bash
halo auth current
halo auth profile list
halo auth profile use production
halo auth profile get production --json
```

Diagnose broken credentials:

```bash
halo auth profile doctor
halo auth profile delete production --force
halo auth login --profile production --url https://halo.example.com --auth-type bearer --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.

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