CxLLM-ARA/README.md
CxAI Ops ab00cc64ff
Some checks are pending
ci / validate (push) Waiting to run
chore: initial commit (Phase 3 scaffold)
2026-05-16 10:52:03 -05:00

54 lines
1.8 KiB
Markdown

# CxLLM-ARA
> CxLLM Augmented Reality Assistant
ARKit + RealityKit application that surfaces CxLLM inference results as world-anchored UI for spatial assistant scenarios.
[![ci](https://git.cxllm-studio.com/CxAI-LLM/CxLLM-ARA/actions/workflows/ci.yml/badge.svg)](https://git.cxllm-studio.com/CxAI-LLM/CxLLM-ARA/actions)
[![license](https://img.shields.io/badge/license-MIT-7C3AED)](LICENSE)
[![category](https://img.shields.io/badge/category-app-arkit-1F6FEB)](#)
## Overview
`CxLLM-ARA` 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 **app-arkit** concerns and is
intentionally narrow so that the CxLLM monorepo can compose targets without
pulling in unrelated dependencies.
## Repository layout
- `CxLLM-ARA/` — primary source folder (matches the Xcode group / SwiftPM root).
- `CxLLM-ARA.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.