# CxLLM-PLG

> CxLLM Installer plug-in

Apple Installer.app plug-in (Objective-C) that drives the macOS install/upgrade flow for the CxLLM bundle.

[![ci](https://git.cxllm-studio.com/CxAI-LLM/CxLLM-PLG/actions/workflows/ci.yml/badge.svg)](https://git.cxllm-studio.com/CxAI-LLM/CxLLM-PLG/actions)
[![license](https://img.shields.io/badge/license-MIT-7C3AED)](LICENSE)
[![category](https://img.shields.io/badge/category-installer-plugin-1F6FEB)](#)

## Overview

`CxLLM-PLG` is part of the **CxLLM** product family — a layered runtime that
spans Apple kernel extensions, user-space frameworks, host applications, and
spatial / web surfaces. This module focuses on **installer-plugin** concerns and is
intentionally narrow so that the CxLLM monorepo can compose targets without
pulling in unrelated dependencies.

## Repository layout

- `CxLLM-PLG/` — primary source folder (matches the Xcode group / SwiftPM root).
- `CxLLM-PLG.xcodeproj` — Xcode project (where applicable).
- `Makefile` — common entry points (`build`, `test`, `lint`, `clean`).
- `.github/workflows/ci.yml` — CI pipeline (Xcode build + lint).
- `docs/` — architecture notes and ADRs.

## Quick start

```bash
# Build (defaults to Debug for the host platform):
make build

# Run the full test suite (unit + UI where applicable):
make test

# Static analysis + format check:
make lint
```

## Versioning

This module follows [Semantic Versioning 2.0](https://semver.org/) and is
released in lock-step with the umbrella **CxLLM** product line. See
[`CHANGELOG.md`](CHANGELOG.md) for the user-facing change log.

## Security

Please report security issues per [`SECURITY.md`](SECURITY.md). Do **not**
open public issues for vulnerabilities.

## License

Released under the [MIT License](LICENSE) © 2026 CxAI-LLM.