git:20260526.4932a85 to git:20260606.348f874

7 added, 9 removed. Audit A to A.

- # HaloPSA Skill Agent Guide

+ # HaloPSA Printed CLI Agent Guide

- This directory ships a `halopsa-cli` binary and an MCP server (`halopsa-mcp`) for use by Claude Code, Codex, Claude Desktop, and ChatGPT Desktop. This file gives the agent invariant local guidance; the longer command reference is in `guide.md`.

+ This directory is a generated `halopsa-cli` printed CLI. It was produced by [CLI Printing Press](https://github.com/mvanhorn/cli-printing-press), so treat systemic fixes as upstream Printing Press fixes first. Keep local edits narrow and document why a generated-tree patch belongs here.

## Local Operating Contract

- Start by asking the CLI for current runtime truth:

+ Start by asking the generated CLI for current runtime truth:

```bash

halopsa-cli doctor --json

halopsa-cli agent-context --pretty

```

Use runtime discovery instead of relying on a copied command list:

```bash

halopsa-cli which "<capability>" --json

halopsa-cli <command> --help

```

Add `--agent` to command invocations for JSON, compact output, non-interactive defaults, no color, and confirmation-safe scripting:

```bash

halopsa-cli <command> --agent

```

Before running an unfamiliar command that may mutate remote state, inspect its help and prefer a dry run:

```bash

halopsa-cli <command> --help

halopsa-cli <command> --dry-run --agent

```

Use `--yes --no-input` only after the target, arguments, and side effects are clear.

- For install, auth, examples, and longer product guidance, read `README.md` for the short path and `guide.md` for the full command reference. `SKILL.md` is the Claude Code skill entry point; if you are Claude Code or Codex, that is the file you load on `use halopsa` or `run halopsa` trigger phrases.

- ## Vendor non-affiliation

+ For install, auth, examples, and longer product guidance, read `README.md` and `SKILL.md`. This file intentionally stays small so repo-local agents get invariant local guidance without duplicating the generated docs.

- This skill is unofficial. It is not affiliated with, endorsed by, or sponsored by Halo Service Solutions Ltd. HaloPSA, HaloITSM, and HaloCRM are trademarks of Halo Service Solutions Ltd. Skills here use those names only descriptively, to indicate API compatibility. See `TRADEMARKS.md` at the repo root.

+ ## Local Customizations

- ## Upstream toolchain

+ This directory is **generated output** -- a fresh print can overwrite the whole tree, so ad-hoc hand-edits don't survive on their own. If you modify the generated code, record each change under `.printing-press-patches/` (parallel to `.printing-press.json`) so a regen carries the intent forward instead of silently dropping it.

- The CLI and MCP binaries in this skill are generated by the [CLI Printing Press](https://github.com/mvanhorn/cli-printing-press) toolchain. When you encounter a systemic issue (poor command shape, wrong tool description across many tools, generator-side bug), file it upstream rather than patching it here. `msp-skills` is the distribution surface, not the build factory.

+ The entry shape, and the altitude to write it at -- a durable reprint-guard, not a changelog -- live in the source catalog's `AGENTS.md`, which is the single source of truth; this guide intentionally doesn't duplicate them.