AGENTS.md@skills/halopsa git:20260526.4932a85A

Immutable. This exact content is served forever at /api/v1/blob/c1a26ecaa3fb3c34.

# HaloPSA Skill 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`.

## Local Operating Contract

Start by asking the 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

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.

## Upstream toolchain

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.