halo-cli-shared

Shared instructions for Halo CLI, a terminal program for managing Halo websites and content. They cover login profiles, JSON output, command discovery, configuration, and safeguards for risky actions.

In plain words
What is it for?
Use them as the starting point for Halo CLI tasks, especially when selecting a profile, checking command help, automating output, or confirming a potentially destructive command.
Why use it?
They provide the common rules needed before using Halo's separate commands for posts, pages, plugins, themes, backups, or other site operations. They also clarify which public searches can work without login.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/halo-dev/cli/halo-cli-shared
Any agent
npx skills add halo-dev/cli --skill halo-cli-shared
Clone the repo
git clone --depth 1 https://github.com/halo-dev/cli

Made for: Claude Code, Codex.

Per session 80 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 578 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00080 $0.00578
Opus 5 $0.00040 $0.00289
Sonnet 5 $0.00016 $0.00116
Haiku 4.5 $0.00008 $0.00058

Measured 2d ago against content hash 8e533864db3f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

halo-cli-shared scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/halo-cli-shared/SKILL.md · 89 lines

What it actually says

Halo CLI Shared

Start here when the task says "use Halo CLI" but does not yet say whether it is auth, content, search, operations, or moderation.

Install And Verify

Install globally:

npm install -g @halo-dev/cli

Binary name:

halo

Check version and top-level help:

halo --version
halo --help

Top-Level Areas

  • auth
  • post
  • single-page
  • search
  • plugin
  • theme
  • attachment
  • backup
  • moment
  • comment
  • notification
  • completion <shell> — Generate shell completion script (bash, zsh, fish, powershell)

Shared Rules

  • Most command areas require an authenticated profile.
  • Use halo auth login to create a profile.
  • Use --profile <name> when more than one profile exists.
  • Use --json when output is meant for automation or follow-up parsing.
  • In non-interactive mode, dangerous commands usually require --force.
  • Read --help before guessing flags for a specific command.

Public vs Authenticated

Most areas require auth.

The main public workflow is halo search, which can use a direct site URL without login:

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

Config And Secrets

Profile metadata is stored in:

  • $HALO_CLI_CONFIG_DIR/config.json if HALO_CLI_CONFIG_DIR is set
  • otherwise $XDG_CONFIG_HOME/halo/config.json
  • otherwise ~/.config/halo/config.json

Credentials are stored in the system keyring.

Routing

  • Use halo-cli-auth for login, current profile, profile list/use/delete, and credential repair.
  • 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.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 89 lines · 80 tokens per session scan A 8e533864db3f

Subscribe to this mod's changes

halo-cli-shared is a skill published in the GitHub repository halo-dev/cli (29 stars, last pushed 2mo ago), licensed MIT. It adds 80 tokens to every session and 578 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

swarmclaw

AI agent runtime and multi-agent orchestration platform. Teaches agents how to use SwarmClaw's 6 primitive tools, persistent memory, dreaming, delegation, connectors, credentials, and the skill system. Use when an agent is running on SwarmClaw and needs to understand the platform's capabilities.

swarmclawai/swarmclaw · 67 tokens

gh-issues

Fetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments. Usage: /gh-issues [owner/repo] [--label bug] [--limit 5] [--milestone v1.0] [--assignee @me] [--fork user/repo] [--watch] [--interval 5] [--reviews-only] [--cron] [--dry-run] [--model glm-5]…

SafeAI-Lab-X/ClawKeeper · 116 tokens

prose

OpenProse VM skill pack. Activate on any prose command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.

SafeAI-Lab-X/ClawKeeper · 36 tokens

skill-creator

Create, edit, improve, or audit AgentSkills. Use when creating a new skill from scratch or when asked to improve, review, audit, tidy up, or clean up an existing skill or SKILL.md file. Also use when editing or restructuring a skill directory (moving files to references/ or scripts/, removing stale content, validating…

SafeAI-Lab-X/ClawKeeper · 121 tokens

feishu-safety-guide

One-click deployment Skill for Feishu security governance and message anti-data-leakage guide, responsible for Feishu message security, credential protection, permission auditing, interaction logging and periodic security reporting.

SafeAI-Lab-X/ClawKeeper · 43 tokens

healthcheck

Host security hardening and risk-tolerance configuration for OpenClaw deployments. Use when a user asks for security audits, firewall/SSH/update hardening, risk posture, exposure review, OpenClaw cron scheduling for periodic checks, or version status checks on a machine running OpenClaw (laptop, workstation, Pi, VPS).

SafeAI-Lab-X/ClawKeeper · 70 tokens