# Pp 3cx Xapi

Every 3CX Configuration API (XAPI) object in one Go binary, with a local mirror of your...

- Repository: https://github.com/mvanhorn/printing-press-library (2101 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mvanhorn/printing-press-library --skill pp-3cx-xapi -g -a claude-code -y`
Codex: `npx skills add mvanhorn/printing-press-library --skill pp-3cx-xapi -g -a codex -y`
Cursor: `npx skills add mvanhorn/printing-press-library --skill pp-3cx-xapi -g -a cursor -y`
Gemini CLI: `npx skills add mvanhorn/printing-press-library --skill pp-3cx-xapi -g -a gemini-cli -y`

## Description

Every 3CX Configuration API (XAPI) object in one Go binary, with a local mirror of your whole PBX, offline search, config diffing, and cross-entity auditing no 3CX tool has. Trigger phrases: `audit my 3cx config`, `what changed on the pbx`, `provision 3cx extensions`, `queue sla report 3cx`, `trace extension 214`, `use 3cx-xapi`, `run 3cx-xapi`.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!-- GENERATED FILE, DO NOT EDIT.
     This file is a verbatim mirror of library/social-and-messaging/3cx-xapi/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# 3CX, Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `3cx-xapi-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install 3cx-xapi --cli-only
   ```
2. Verify: `3cx-xapi-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into `$GOPATH/bin` (default `$HOME/go/bin`), so add that directory to `$PATH` instead:

```bash
go install github.com/mvanhorn/printing-press-library/library/social-and-messaging/3cx-xapi/cmd/3cx-xapi-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

Covers the full 3CX V20+ Configuration API: users, groups, ring groups, queues, IVRs, trunks, DIDs, in/outbound rules, reporting, backups, security, and integrations. Beyond CRUD, it mirrors the entire config graph into local SQLite so you can search it offline, diff it over time, audit it for dangling references, roll up queue and agent performance, and trace exactly what routes to an extension.

## When to Use This CLI

The rest: https://github.com/mvanhorn/printing-press-library/blob/HEAD/cli-skills/pp-3cx-xapi/SKILL.md