commit a37afee2fed6c1cdb29e89b6e8292760c037f5b9
Author: CxAI Ops <cxai-ops@cxai-studio.com>
Date:   Sat May 16 10:52:05 2026 -0500

    chore: initial commit (Phase 3 scaffold)

diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..5ef197b
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.{yml,yaml,json,md}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab
diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
new file mode 100644
index 0000000..2a804da
--- /dev/null
+++ b/.gitea/workflows/ci.yml
@@ -0,0 +1,36 @@
+name: ci
+on:
+  push:
+    branches: [main, master]
+  pull_request: {}
+  workflow_dispatch: {}
+
+# We run a Linux runner; macOS xcodebuild is not available here.
+# This workflow validates structure (yaml, file presence) and basic Swift.
+jobs:
+  validate:
+    runs-on: cxai-hostinger
+    container: debian:bookworm
+    steps:
+      - name: Install deps
+        run: |
+          apt-get update -qq
+          apt-get install -y --no-install-recommends git ca-certificates curl python3-yaml >/dev/null
+      - uses: actions/checkout@v4
+      - name: Lint workflow YAML
+        run: |
+          python3 - <<'PY'
+          import sys, yaml, glob
+          for f in glob.glob('.gitea/workflows/*.yml') + glob.glob('.github/workflows/*.yml'):
+              try:
+                  yaml.safe_load(open(f))
+              except Exception as e:
+                  print(f'YAML ERROR {f}: {e}'); sys.exit(1)
+          print('workflows ok')
+          PY
+      - name: Project sanity
+        run: |
+          test -f README.md || (echo "missing README" && exit 1)
+          test -f Makefile  || (echo "missing Makefile" && exit 1)
+          ls *.xcodeproj  >/dev/null 2>&1 && echo "xcodeproj: $(ls -d *.xcodeproj)" || true
+          [ -f Package.swift ] && echo "Package.swift present" || true
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..39d201f
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,27 @@
+name: ci
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    name: build (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [macos-14]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Show toolchain
+        run: |
+          xcodebuild -version || true
+          swift --version    || true
+      - name: Build
+        run: make build
+      - name: Test
+        run: make test
+      - name: Lint
+        run: make lint
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..f4ca831
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,54 @@
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon?
+
+# Xcode
+build/
+DerivedData/
+*.xcworkspace/xcuserdata/
+*.xcodeproj/xcuserdata/
+*.xcodeproj/project.xcworkspace/xcuserdata/
+*.xcuserstate
+*.moved-aside
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+
+# SwiftPM
+.build/
+.swiftpm/xcode/
+.swiftpm/configuration/
+Package.resolved
+
+# CocoaPods / Carthage
+Pods/
+Carthage/Build/
+
+# fastlane
+fastlane/report.xml
+fastlane/Preview.html
+fastlane/screenshots/**/*.png
+fastlane/test_output/
+
+# Coverage
+*.gcno
+*.gcda
+*.profdata
+*.profraw
+coverage/
+
+# Editors
+.vscode/
+.idea/
+*.swp
+
+# Local
+*.local
+secrets.env
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..df7480f
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to this project will be documented here.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+### Added
+- Repository scaffolding: README, LICENSE (MIT), .gitignore, Makefile,
+  CONTRIBUTING, SECURITY, CODEOWNERS, .editorconfig, CI workflow.
+
+## [0.1.0] - 2026-04-22
+
+### Added
+- Initial app-macos scaffold for CxLLM-OS-APP.
diff --git a/CODEOWNERS b/CODEOWNERS
new file mode 100644
index 0000000..7e6dfca
--- /dev/null
+++ b/CODEOWNERS
@@ -0,0 +1,6 @@
+# Default owners for everything in this repo.
+* @CxAI-LLM/maintainers
+
+# Build & CI
+/.github/      @CxAI-LLM/devops
+/Makefile      @CxAI-LLM/devops
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..cfcae40
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,23 @@
+# Contributing to CxLLM-OS-APP
+
+Thanks for taking the time to contribute!
+
+## Workflow
+
+1. Open an issue describing the change before sending a PR for non-trivial work.
+2. Fork / branch off `main`. Use a descriptive branch name (`feat/...`, `fix/...`).
+3. Keep commits scoped and use **Conventional Commits** (`feat:`, `fix:`,
+   `docs:`, `refactor:`, `test:`, `chore:`).
+4. Run `make lint` and `make test` before pushing.
+5. Open a PR — CI must pass before review.
+
+## Coding style
+
+- Swift: `swiftformat` defaults + `swiftlint` rules from the umbrella repo.
+- Objective-C / C / C++: clang-format `-style=Google`.
+- No tabs in Swift; 4-space indent in C/C++.
+
+## Code of conduct
+
+By contributing you agree to abide by the project's Code of Conduct
+(see the umbrella `cxllm-code` repo).
diff --git a/CxLLM-OS-APP.xcodeproj/project.pbxproj b/CxLLM-OS-APP.xcodeproj/project.pbxproj
new file mode 100644
index 0000000..aaea6c2
--- /dev/null
+++ b/CxLLM-OS-APP.xcodeproj/project.pbxproj
@@ -0,0 +1,578 @@
+// !$*UTF8*$!
+{
+	archiveVersion = 1;
+	classes = {
+	};
+	objectVersion = 77;
+	objects = {
+
+/* Begin PBXContainerItemProxy section */
+		20F2AFE72F99720200E7D2D9 /* PBXContainerItemProxy */ = {
+			isa = PBXContainerItemProxy;
+			containerPortal = 20F2AFCF2F99720000E7D2D9 /* Project object */;
+			proxyType = 1;
+			remoteGlobalIDString = 20F2AFD62F99720000E7D2D9;
+			remoteInfo = "CxLLM-OS-APP";
+		};
+		20F2AFF12F99720200E7D2D9 /* PBXContainerItemProxy */ = {
+			isa = PBXContainerItemProxy;
+			containerPortal = 20F2AFCF2F99720000E7D2D9 /* Project object */;
+			proxyType = 1;
+			remoteGlobalIDString = 20F2AFD62F99720000E7D2D9;
+			remoteInfo = "CxLLM-OS-APP";
+		};
+/* End PBXContainerItemProxy section */
+
+/* Begin PBXFileReference section */
+		20F2AFD72F99720000E7D2D9 /* CxLLM-OS-APP.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = "CxLLM-OS-APP.app"; sourceTree = BUILT_PRODUCTS_DIR; };
+		20F2AFE62F99720200E7D2D9 /* CxLLM-OS-APPTests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = "CxLLM-OS-APPTests.xctest"; sourceTree = BUILT_PRODUCTS_DIR; };
+		20F2AFF02F99720200E7D2D9 /* CxLLM-OS-APPUITests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = "CxLLM-OS-APPUITests.xctest"; sourceTree = BUILT_PRODUCTS_DIR; };
+/* End PBXFileReference section */
+
+/* Begin PBXFileSystemSynchronizedRootGroup section */
+		20F2AFD92F99720000E7D2D9 /* CxLLM-OS-APP */ = {
+			isa = PBXFileSystemSynchronizedRootGroup;
+			path = "CxLLM-OS-APP";
+			sourceTree = "<group>";
+		};
+		20F2AFE92F99720200E7D2D9 /* CxLLM-OS-APPTests */ = {
+			isa = PBXFileSystemSynchronizedRootGroup;
+			path = "CxLLM-OS-APPTests";
+			sourceTree = "<group>";
+		};
+		20F2AFF32F99720200E7D2D9 /* CxLLM-OS-APPUITests */ = {
+			isa = PBXFileSystemSynchronizedRootGroup;
+			path = "CxLLM-OS-APPUITests";
+			sourceTree = "<group>";
+		};
+/* End PBXFileSystemSynchronizedRootGroup section */
+
+/* Begin PBXFrameworksBuildPhase section */
+		20F2AFD42F99720000E7D2D9 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		20F2AFE32F99720200E7D2D9 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		20F2AFED2F99720200E7D2D9 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXFrameworksBuildPhase section */
+
+/* Begin PBXGroup section */
+		20F2AFCE2F99720000E7D2D9 = {
+			isa = PBXGroup;
+			children = (
+				20F2AFD92F99720000E7D2D9 /* CxLLM-OS-APP */,
+				20F2AFE92F99720200E7D2D9 /* CxLLM-OS-APPTests */,
+				20F2AFF32F99720200E7D2D9 /* CxLLM-OS-APPUITests */,
+				20F2AFD82F99720000E7D2D9 /* Products */,
+			);
+			sourceTree = "<group>";
+		};
+		20F2AFD82F99720000E7D2D9 /* Products */ = {
+			isa = PBXGroup;
+			children = (
+				20F2AFD72F99720000E7D2D9 /* CxLLM-OS-APP.app */,
+				20F2AFE62F99720200E7D2D9 /* CxLLM-OS-APPTests.xctest */,
+				20F2AFF02F99720200E7D2D9 /* CxLLM-OS-APPUITests.xctest */,
+			);
+			name = Products;
+			sourceTree = "<group>";
+		};
+/* End PBXGroup section */
+
+/* Begin PBXNativeTarget section */
+		20F2AFD62F99720000E7D2D9 /* CxLLM-OS-APP */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 20F2AFFA2F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APP" */;
+			buildPhases = (
+				20F2AFD32F99720000E7D2D9 /* Sources */,
+				20F2AFD42F99720000E7D2D9 /* Frameworks */,
+				20F2AFD52F99720000E7D2D9 /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			fileSystemSynchronizedGroups = (
+				20F2AFD92F99720000E7D2D9 /* CxLLM-OS-APP */,
+			);
+			name = "CxLLM-OS-APP";
+			packageProductDependencies = (
+			);
+			productName = "CxLLM-OS-APP";
+			productReference = 20F2AFD72F99720000E7D2D9 /* CxLLM-OS-APP.app */;
+			productType = "com.apple.product-type.application";
+		};
+		20F2AFE52F99720200E7D2D9 /* CxLLM-OS-APPTests */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 20F2AFFD2F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APPTests" */;
+			buildPhases = (
+				20F2AFE22F99720200E7D2D9 /* Sources */,
+				20F2AFE32F99720200E7D2D9 /* Frameworks */,
+				20F2AFE42F99720200E7D2D9 /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+				20F2AFE82F99720200E7D2D9 /* PBXTargetDependency */,
+			);
+			fileSystemSynchronizedGroups = (
+				20F2AFE92F99720200E7D2D9 /* CxLLM-OS-APPTests */,
+			);
+			name = "CxLLM-OS-APPTests";
+			packageProductDependencies = (
+			);
+			productName = "CxLLM-OS-APPTests";
+			productReference = 20F2AFE62F99720200E7D2D9 /* CxLLM-OS-APPTests.xctest */;
+			productType = "com.apple.product-type.bundle.unit-test";
+		};
+		20F2AFEF2F99720200E7D2D9 /* CxLLM-OS-APPUITests */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 20F2B0002F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APPUITests" */;
+			buildPhases = (
+				20F2AFEC2F99720200E7D2D9 /* Sources */,
+				20F2AFED2F99720200E7D2D9 /* Frameworks */,
+				20F2AFEE2F99720200E7D2D9 /* Resources */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+				20F2AFF22F99720200E7D2D9 /* PBXTargetDependency */,
+			);
+			fileSystemSynchronizedGroups = (
+				20F2AFF32F99720200E7D2D9 /* CxLLM-OS-APPUITests */,
+			);
+			name = "CxLLM-OS-APPUITests";
+			packageProductDependencies = (
+			);
+			productName = "CxLLM-OS-APPUITests";
+			productReference = 20F2AFF02F99720200E7D2D9 /* CxLLM-OS-APPUITests.xctest */;
+			productType = "com.apple.product-type.bundle.ui-testing";
+		};
+/* End PBXNativeTarget section */
+
+/* Begin PBXProject section */
+		20F2AFCF2F99720000E7D2D9 /* Project object */ = {
+			isa = PBXProject;
+			attributes = {
+				BuildIndependentTargetsInParallel = 1;
+				LastSwiftUpdateCheck = 2630;
+				LastUpgradeCheck = 2630;
+				TargetAttributes = {
+					20F2AFD62F99720000E7D2D9 = {
+						CreatedOnToolsVersion = 26.3;
+					};
+					20F2AFE52F99720200E7D2D9 = {
+						CreatedOnToolsVersion = 26.3;
+						TestTargetID = 20F2AFD62F99720000E7D2D9;
+					};
+					20F2AFEF2F99720200E7D2D9 = {
+						CreatedOnToolsVersion = 26.3;
+						TestTargetID = 20F2AFD62F99720000E7D2D9;
+					};
+				};
+			};
+			buildConfigurationList = 20F2AFD22F99720000E7D2D9 /* Build configuration list for PBXProject "CxLLM-OS-APP" */;
+			developmentRegion = en;
+			hasScannedForEncodings = 0;
+			knownRegions = (
+				en,
+				Base,
+			);
+			mainGroup = 20F2AFCE2F99720000E7D2D9;
+			minimizedProjectReferenceProxies = 1;
+			preferredProjectObjectVersion = 77;
+			productRefGroup = 20F2AFD82F99720000E7D2D9 /* Products */;
+			projectDirPath = "";
+			projectRoot = "";
+			targets = (
+				20F2AFD62F99720000E7D2D9 /* CxLLM-OS-APP */,
+				20F2AFE52F99720200E7D2D9 /* CxLLM-OS-APPTests */,
+				20F2AFEF2F99720200E7D2D9 /* CxLLM-OS-APPUITests */,
+			);
+		};
+/* End PBXProject section */
+
+/* Begin PBXResourcesBuildPhase section */
+		20F2AFD52F99720000E7D2D9 /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		20F2AFE42F99720200E7D2D9 /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		20F2AFEE2F99720200E7D2D9 /* Resources */ = {
+			isa = PBXResourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXResourcesBuildPhase section */
+
+/* Begin PBXSourcesBuildPhase section */
+		20F2AFD32F99720000E7D2D9 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		20F2AFE22F99720200E7D2D9 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+		20F2AFEC2F99720200E7D2D9 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
+/* End PBXSourcesBuildPhase section */
+
+/* Begin PBXTargetDependency section */
+		20F2AFE82F99720200E7D2D9 /* PBXTargetDependency */ = {
+			isa = PBXTargetDependency;
+			target = 20F2AFD62F99720000E7D2D9 /* CxLLM-OS-APP */;
+			targetProxy = 20F2AFE72F99720200E7D2D9 /* PBXContainerItemProxy */;
+		};
+		20F2AFF22F99720200E7D2D9 /* PBXTargetDependency */ = {
+			isa = PBXTargetDependency;
+			target = 20F2AFD62F99720000E7D2D9 /* CxLLM-OS-APP */;
+			targetProxy = 20F2AFF12F99720200E7D2D9 /* PBXContainerItemProxy */;
+		};
+/* End PBXTargetDependency section */
+
+/* Begin XCBuildConfiguration section */
+		20F2AFF82F99720200E7D2D9 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_ENABLE_OBJC_WEAK = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = dwarf;
+				DEVELOPMENT_TEAM = DKWVC9FQJY;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_TESTABILITY = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu17;
+				GCC_DYNAMIC_NO_PIC = NO;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_OPTIMIZATION_LEVEL = 0;
+				GCC_PREPROCESSOR_DEFINITIONS = (
+					"DEBUG=1",
+					"$(inherited)",
+				);
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
+				MACOSX_DEPLOYMENT_TARGET = 26.2;
+				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
+				MTL_FAST_MATH = YES;
+				ONLY_ACTIVE_ARCH = YES;
+				SDKROOT = macosx;
+				SWIFT_ACTIVE_COMPILATION_CONDITIONS = "DEBUG $(inherited)";
+				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+			};
+			name = Debug;
+		};
+		20F2AFF92F99720200E7D2D9 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ALWAYS_SEARCH_USER_PATHS = NO;
+				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
+				CLANG_ANALYZER_NONNULL = YES;
+				CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
+				CLANG_ENABLE_MODULES = YES;
+				CLANG_ENABLE_OBJC_ARC = YES;
+				CLANG_ENABLE_OBJC_WEAK = YES;
+				CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
+				CLANG_WARN_BOOL_CONVERSION = YES;
+				CLANG_WARN_COMMA = YES;
+				CLANG_WARN_CONSTANT_CONVERSION = YES;
+				CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
+				CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
+				CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
+				CLANG_WARN_EMPTY_BODY = YES;
+				CLANG_WARN_ENUM_CONVERSION = YES;
+				CLANG_WARN_INFINITE_RECURSION = YES;
+				CLANG_WARN_INT_CONVERSION = YES;
+				CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
+				CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
+				CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
+				CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
+				CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
+				CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
+				CLANG_WARN_STRICT_PROTOTYPES = YES;
+				CLANG_WARN_SUSPICIOUS_MOVE = YES;
+				CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
+				CLANG_WARN_UNREACHABLE_CODE = YES;
+				CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
+				COPY_PHASE_STRIP = NO;
+				DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
+				DEVELOPMENT_TEAM = DKWVC9FQJY;
+				ENABLE_NS_ASSERTIONS = NO;
+				ENABLE_STRICT_OBJC_MSGSEND = YES;
+				ENABLE_USER_SCRIPT_SANDBOXING = YES;
+				GCC_C_LANGUAGE_STANDARD = gnu17;
+				GCC_NO_COMMON_BLOCKS = YES;
+				GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
+				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
+				GCC_WARN_UNDECLARED_SELECTOR = YES;
+				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
+				GCC_WARN_UNUSED_FUNCTION = YES;
+				GCC_WARN_UNUSED_VARIABLE = YES;
+				LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
+				MACOSX_DEPLOYMENT_TARGET = 26.2;
+				MTL_ENABLE_DEBUG_INFO = NO;
+				MTL_FAST_MATH = YES;
+				SDKROOT = macosx;
+				SWIFT_COMPILATION_MODE = wholemodule;
+			};
+			name = Release;
+		};
+		20F2AFFB2F99720200E7D2D9 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
+				CODE_SIGN_STYLE = Automatic;
+				COMBINE_HIDPI_IMAGES = YES;
+				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = DKWVC9FQJY;
+				ENABLE_APP_SANDBOX = YES;
+				ENABLE_HARDENED_RUNTIME = YES;
+				ENABLE_PREVIEWS = YES;
+				ENABLE_USER_SELECTED_FILES = readonly;
+				GENERATE_INFOPLIST_FILE = YES;
+				INFOPLIST_KEY_NSHumanReadableCopyright = "";
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/../Frameworks",
+				);
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APP";
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				REGISTER_APP_GROUPS = YES;
+				STRING_CATALOG_GENERATE_SYMBOLS = YES;
+				SWIFT_APPROACHABLE_CONCURRENCY = YES;
+				SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor;
+				SWIFT_EMIT_LOC_STRINGS = YES;
+				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
+				SWIFT_VERSION = 5.0;
+			};
+			name = Debug;
+		};
+		20F2AFFC2F99720200E7D2D9 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
+				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
+				CODE_SIGN_STYLE = Automatic;
+				COMBINE_HIDPI_IMAGES = YES;
+				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = DKWVC9FQJY;
+				ENABLE_APP_SANDBOX = YES;
+				ENABLE_HARDENED_RUNTIME = YES;
+				ENABLE_PREVIEWS = YES;
+				ENABLE_USER_SELECTED_FILES = readonly;
+				GENERATE_INFOPLIST_FILE = YES;
+				INFOPLIST_KEY_NSHumanReadableCopyright = "";
+				LD_RUNPATH_SEARCH_PATHS = (
+					"$(inherited)",
+					"@executable_path/../Frameworks",
+				);
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APP";
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				REGISTER_APP_GROUPS = YES;
+				STRING_CATALOG_GENERATE_SYMBOLS = YES;
+				SWIFT_APPROACHABLE_CONCURRENCY = YES;
+				SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor;
+				SWIFT_EMIT_LOC_STRINGS = YES;
+				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
+				SWIFT_VERSION = 5.0;
+			};
+			name = Release;
+		};
+		20F2AFFE2F99720200E7D2D9 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = DKWVC9FQJY;
+				GENERATE_INFOPLIST_FILE = YES;
+				MACOSX_DEPLOYMENT_TARGET = 26.2;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APPTests";
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				STRING_CATALOG_GENERATE_SYMBOLS = NO;
+				SWIFT_APPROACHABLE_CONCURRENCY = YES;
+				SWIFT_EMIT_LOC_STRINGS = NO;
+				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/CxLLM-OS-APP.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/CxLLM-OS-APP";
+			};
+			name = Debug;
+		};
+		20F2AFFF2F99720200E7D2D9 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				BUNDLE_LOADER = "$(TEST_HOST)";
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = DKWVC9FQJY;
+				GENERATE_INFOPLIST_FILE = YES;
+				MACOSX_DEPLOYMENT_TARGET = 26.2;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APPTests";
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				STRING_CATALOG_GENERATE_SYMBOLS = NO;
+				SWIFT_APPROACHABLE_CONCURRENCY = YES;
+				SWIFT_EMIT_LOC_STRINGS = NO;
+				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
+				SWIFT_VERSION = 5.0;
+				TEST_HOST = "$(BUILT_PRODUCTS_DIR)/CxLLM-OS-APP.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/CxLLM-OS-APP";
+			};
+			name = Release;
+		};
+		20F2B0012F99720200E7D2D9 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = DKWVC9FQJY;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APPUITests";
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				STRING_CATALOG_GENERATE_SYMBOLS = NO;
+				SWIFT_APPROACHABLE_CONCURRENCY = YES;
+				SWIFT_EMIT_LOC_STRINGS = NO;
+				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
+				SWIFT_VERSION = 5.0;
+				TEST_TARGET_NAME = "CxLLM-OS-APP";
+			};
+			name = Debug;
+		};
+		20F2B0022F99720200E7D2D9 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CODE_SIGN_STYLE = Automatic;
+				CURRENT_PROJECT_VERSION = 1;
+				DEVELOPMENT_TEAM = DKWVC9FQJY;
+				GENERATE_INFOPLIST_FILE = YES;
+				MARKETING_VERSION = 1.0;
+				PRODUCT_BUNDLE_IDENTIFIER = "cxai-studio.CxLLM-OS-APPUITests";
+				PRODUCT_NAME = "$(TARGET_NAME)";
+				STRING_CATALOG_GENERATE_SYMBOLS = NO;
+				SWIFT_APPROACHABLE_CONCURRENCY = YES;
+				SWIFT_EMIT_LOC_STRINGS = NO;
+				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
+				SWIFT_VERSION = 5.0;
+				TEST_TARGET_NAME = "CxLLM-OS-APP";
+			};
+			name = Release;
+		};
+/* End XCBuildConfiguration section */
+
+/* Begin XCConfigurationList section */
+		20F2AFD22F99720000E7D2D9 /* Build configuration list for PBXProject "CxLLM-OS-APP" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				20F2AFF82F99720200E7D2D9 /* Debug */,
+				20F2AFF92F99720200E7D2D9 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		20F2AFFA2F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APP" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				20F2AFFB2F99720200E7D2D9 /* Debug */,
+				20F2AFFC2F99720200E7D2D9 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		20F2AFFD2F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APPTests" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				20F2AFFE2F99720200E7D2D9 /* Debug */,
+				20F2AFFF2F99720200E7D2D9 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+		20F2B0002F99720200E7D2D9 /* Build configuration list for PBXNativeTarget "CxLLM-OS-APPUITests" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				20F2B0012F99720200E7D2D9 /* Debug */,
+				20F2B0022F99720200E7D2D9 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
+/* End XCConfigurationList section */
+	};
+	rootObject = 20F2AFCF2F99720000E7D2D9 /* Project object */;
+}
diff --git a/CxLLM-OS-APP.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/CxLLM-OS-APP.xcodeproj/project.xcworkspace/contents.xcworkspacedata
new file mode 100644
index 0000000..919434a
--- /dev/null
+++ b/CxLLM-OS-APP.xcodeproj/project.xcworkspace/contents.xcworkspacedata
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Workspace
+   version = "1.0">
+   <FileRef
+      location = "self:">
+   </FileRef>
+</Workspace>
diff --git a/CxLLM-OS-APP/Assets.xcassets/AccentColor.colorset/Contents.json b/CxLLM-OS-APP/Assets.xcassets/AccentColor.colorset/Contents.json
new file mode 100644
index 0000000..eb87897
--- /dev/null
+++ b/CxLLM-OS-APP/Assets.xcassets/AccentColor.colorset/Contents.json
@@ -0,0 +1,11 @@
+{
+  "colors" : [
+    {
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}
diff --git a/CxLLM-OS-APP/Assets.xcassets/AppIcon.appiconset/Contents.json b/CxLLM-OS-APP/Assets.xcassets/AppIcon.appiconset/Contents.json
new file mode 100644
index 0000000..3f00db4
--- /dev/null
+++ b/CxLLM-OS-APP/Assets.xcassets/AppIcon.appiconset/Contents.json
@@ -0,0 +1,58 @@
+{
+  "images" : [
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "16x16"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "16x16"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "32x32"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "32x32"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "128x128"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "128x128"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "256x256"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "256x256"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "1x",
+      "size" : "512x512"
+    },
+    {
+      "idiom" : "mac",
+      "scale" : "2x",
+      "size" : "512x512"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}
diff --git a/CxLLM-OS-APP/Assets.xcassets/Contents.json b/CxLLM-OS-APP/Assets.xcassets/Contents.json
new file mode 100644
index 0000000..73c0059
--- /dev/null
+++ b/CxLLM-OS-APP/Assets.xcassets/Contents.json
@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}
diff --git a/CxLLM-OS-APP/ContentView.swift b/CxLLM-OS-APP/ContentView.swift
new file mode 100644
index 0000000..6389ae2
--- /dev/null
+++ b/CxLLM-OS-APP/ContentView.swift
@@ -0,0 +1,59 @@
+//
+//  ContentView.swift
+//  CxLLM-OS-APP
+//
+//  Created by Stephen Carter on 4/22/26.
+//
+
+import SwiftUI
+import SwiftData
+
+struct ContentView: View {
+    @Environment(\.modelContext) private var modelContext
+    @Query private var items: [Item]
+
+    var body: some View {
+        NavigationSplitView {
+            List {
+                ForEach(items) { item in
+                    NavigationLink {
+                        Text("Item at \(item.timestamp, format: Date.FormatStyle(date: .numeric, time: .standard))")
+                    } label: {
+                        Text(item.timestamp, format: Date.FormatStyle(date: .numeric, time: .standard))
+                    }
+                }
+                .onDelete(perform: deleteItems)
+            }
+            .navigationSplitViewColumnWidth(min: 180, ideal: 200)
+            .toolbar {
+                ToolbarItem {
+                    Button(action: addItem) {
+                        Label("Add Item", systemImage: "plus")
+                    }
+                }
+            }
+        } detail: {
+            Text("Select an item")
+        }
+    }
+
+    private func addItem() {
+        withAnimation {
+            let newItem = Item(timestamp: Date())
+            modelContext.insert(newItem)
+        }
+    }
+
+    private func deleteItems(offsets: IndexSet) {
+        withAnimation {
+            for index in offsets {
+                modelContext.delete(items[index])
+            }
+        }
+    }
+}
+
+#Preview {
+    ContentView()
+        .modelContainer(for: Item.self, inMemory: true)
+}
diff --git a/CxLLM-OS-APP/CxLLM_OS_APPApp.swift b/CxLLM-OS-APP/CxLLM_OS_APPApp.swift
new file mode 100644
index 0000000..1c63d66
--- /dev/null
+++ b/CxLLM-OS-APP/CxLLM_OS_APPApp.swift
@@ -0,0 +1,32 @@
+//
+//  CxLLM_OS_APPApp.swift
+//  CxLLM-OS-APP
+//
+//  Created by Stephen Carter on 4/22/26.
+//
+
+import SwiftUI
+import SwiftData
+
+@main
+struct CxLLM_OS_APPApp: App {
+    var sharedModelContainer: ModelContainer = {
+        let schema = Schema([
+            Item.self,
+        ])
+        let modelConfiguration = ModelConfiguration(schema: schema, isStoredInMemoryOnly: false)
+
+        do {
+            return try ModelContainer(for: schema, configurations: [modelConfiguration])
+        } catch {
+            fatalError("Could not create ModelContainer: \(error)")
+        }
+    }()
+
+    var body: some Scene {
+        WindowGroup {
+            ContentView()
+        }
+        .modelContainer(sharedModelContainer)
+    }
+}
diff --git a/CxLLM-OS-APP/Item.swift b/CxLLM-OS-APP/Item.swift
new file mode 100644
index 0000000..af4f04f
--- /dev/null
+++ b/CxLLM-OS-APP/Item.swift
@@ -0,0 +1,18 @@
+//
+//  Item.swift
+//  CxLLM-OS-APP
+//
+//  Created by Stephen Carter on 4/22/26.
+//
+
+import Foundation
+import SwiftData
+
+@Model
+final class Item {
+    var timestamp: Date
+    
+    init(timestamp: Date) {
+        self.timestamp = timestamp
+    }
+}
diff --git a/CxLLM-OS-APPTests/CxLLM_OS_APPTests.swift b/CxLLM-OS-APPTests/CxLLM_OS_APPTests.swift
new file mode 100644
index 0000000..bfbeb60
--- /dev/null
+++ b/CxLLM-OS-APPTests/CxLLM_OS_APPTests.swift
@@ -0,0 +1,17 @@
+//
+//  CxLLM_OS_APPTests.swift
+//  CxLLM-OS-APPTests
+//
+//  Created by Stephen Carter on 4/22/26.
+//
+
+import Testing
+@testable import CxLLM_OS_APP
+
+struct CxLLM_OS_APPTests {
+
+    @Test func example() async throws {
+        // Write your test here and use APIs like `#expect(...)` to check expected conditions.
+    }
+
+}
diff --git a/CxLLM-OS-APPUITests/CxLLM_OS_APPUITests.swift b/CxLLM-OS-APPUITests/CxLLM_OS_APPUITests.swift
new file mode 100644
index 0000000..27b3a71
--- /dev/null
+++ b/CxLLM-OS-APPUITests/CxLLM_OS_APPUITests.swift
@@ -0,0 +1,41 @@
+//
+//  CxLLM_OS_APPUITests.swift
+//  CxLLM-OS-APPUITests
+//
+//  Created by Stephen Carter on 4/22/26.
+//
+
+import XCTest
+
+final class CxLLM_OS_APPUITests: XCTestCase {
+
+    override func setUpWithError() throws {
+        // Put setup code here. This method is called before the invocation of each test method in the class.
+
+        // In UI tests it is usually best to stop immediately when a failure occurs.
+        continueAfterFailure = false
+
+        // In UI tests it’s important to set the initial state - such as interface orientation - required for your tests before they run. The setUp method is a good place to do this.
+    }
+
+    override func tearDownWithError() throws {
+        // Put teardown code here. This method is called after the invocation of each test method in the class.
+    }
+
+    @MainActor
+    func testExample() throws {
+        // UI tests must launch the application that they test.
+        let app = XCUIApplication()
+        app.launch()
+
+        // Use XCTAssert and related functions to verify your tests produce the correct results.
+    }
+
+    @MainActor
+    func testLaunchPerformance() throws {
+        // This measures how long it takes to launch your application.
+        measure(metrics: [XCTApplicationLaunchMetric()]) {
+            XCUIApplication().launch()
+        }
+    }
+}
diff --git a/CxLLM-OS-APPUITests/CxLLM_OS_APPUITestsLaunchTests.swift b/CxLLM-OS-APPUITests/CxLLM_OS_APPUITestsLaunchTests.swift
new file mode 100644
index 0000000..9efd51b
--- /dev/null
+++ b/CxLLM-OS-APPUITests/CxLLM_OS_APPUITestsLaunchTests.swift
@@ -0,0 +1,33 @@
+//
+//  CxLLM_OS_APPUITestsLaunchTests.swift
+//  CxLLM-OS-APPUITests
+//
+//  Created by Stephen Carter on 4/22/26.
+//
+
+import XCTest
+
+final class CxLLM_OS_APPUITestsLaunchTests: XCTestCase {
+
+    override class var runsForEachTargetApplicationUIConfiguration: Bool {
+        true
+    }
+
+    override func setUpWithError() throws {
+        continueAfterFailure = false
+    }
+
+    @MainActor
+    func testLaunch() throws {
+        let app = XCUIApplication()
+        app.launch()
+
+        // Insert steps here to perform after app launch but before taking a screenshot,
+        // such as logging into a test account or navigating somewhere in the app
+
+        let attachment = XCTAttachment(screenshot: app.screenshot())
+        attachment.name = "Launch Screen"
+        attachment.lifetime = .keepAlways
+        add(attachment)
+    }
+}
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..114f83a
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CxAI-LLM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..25e3ebe
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,43 @@
+# Makefile — common entry points for CxLLM-OS-APP
+SHELL := /bin/bash
+.DEFAULT_GOAL := help
+
+PROJECT := CxLLM-OS-APP
+SCHEME  ?= $(PROJECT)
+CONFIG  ?= Debug
+DERIVED ?= build
+
+.PHONY: help build test lint clean fmt info
+
+help: ## show this help
+	@grep -E '^[a-zA-Z_-]+:.*## ' $(MAKEFILE_LIST) | awk -F':.*## ' '{printf "  %-12s %s\n", $$1, $$2}'
+
+info: ## show project info
+	@echo "project : $(PROJECT)"
+	@echo "scheme  : $(SCHEME)"
+	@echo "config  : $(CONFIG)"
+	@echo "derived : $(DERIVED)"
+
+build: ## xcodebuild build (skip if no .xcodeproj)
+	@if ls *.xcodeproj 1>/dev/null 2>&1; then \
+	  xcodebuild -project "$(PROJECT).xcodeproj" -scheme "$(SCHEME)" -configuration "$(CONFIG)" -derivedDataPath "$(DERIVED)" build | xcbeautify || true ; \
+	elif [ -f Package.swift ]; then \
+	  swift build -c $(shell echo "$(CONFIG)" | tr '[:upper:]' '[:lower:]') ; \
+	else echo "no buildable target" ; fi
+
+test: ## xcodebuild test
+	@if ls *.xcodeproj 1>/dev/null 2>&1; then \
+	  xcodebuild -project "$(PROJECT).xcodeproj" -scheme "$(SCHEME)" -configuration "$(CONFIG)" -derivedDataPath "$(DERIVED)" test | xcbeautify || true ; \
+	elif [ -f Package.swift ]; then \
+	  swift test ; \
+	else echo "no testable target" ; fi
+
+lint: ## swiftlint + swiftformat (no-op if missing)
+	@command -v swiftlint   >/dev/null && swiftlint   --quiet || echo "swiftlint not installed"
+	@command -v swiftformat >/dev/null && swiftformat --lint . || echo "swiftformat not installed"
+
+fmt: ## swiftformat in-place
+	@command -v swiftformat >/dev/null && swiftformat . || echo "swiftformat not installed"
+
+clean: ## remove build artifacts
+	rm -rf "$(DERIVED)" .build DerivedData
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0cd634a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,53 @@
+# CxLLM-OS-APP
+
+> CxLLM OS shell application
+
+SwiftUI/SwiftData macOS shell that exposes CxLLM as a top-level OS application (status item + window scene + URL handler).
+
+[![ci](https://git.cxllm-studio.com/CxAI-LLM/CxLLM-OS-APP/actions/workflows/ci.yml/badge.svg)](https://git.cxllm-studio.com/CxAI-LLM/CxLLM-OS-APP/actions)
+[![license](https://img.shields.io/badge/license-MIT-7C3AED)](LICENSE)
+[![category](https://img.shields.io/badge/category-app-macos-1F6FEB)](#)
+
+## Overview
+
+`CxLLM-OS-APP` 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-macos** concerns and is
+intentionally narrow so that the CxLLM monorepo can compose targets without
+pulling in unrelated dependencies.
+
+## Repository layout
+
+- `CxLLM-OS-APP/` — primary source folder (matches the Xcode group / SwiftPM root).
+- `CxLLM-OS-APP.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.
diff --git a/SECURITY.md b/SECURITY.md
new file mode 100644
index 0000000..f0656ac
--- /dev/null
+++ b/SECURITY.md
@@ -0,0 +1,19 @@
+# Security policy for CxLLM-OS-APP
+
+## Reporting a vulnerability
+
+Please email **security@cxllm-studio.com** with:
+
+- A description of the vulnerability and its impact.
+- Steps to reproduce, ideally with a minimal proof-of-concept.
+- The affected version(s) / commit SHAs.
+
+We aim to acknowledge within **2 business days** and to publish a fix or
+mitigation within **30 days** for high-severity issues.
+
+Do **not** open a public Gitea / GitHub issue for vulnerabilities.
+
+## Supported versions
+
+Only the `main` branch and the most recent tagged release receive security
+updates.
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
new file mode 100644
index 0000000..2997ac8
--- /dev/null
+++ b/docs/ARCHITECTURE.md
@@ -0,0 +1,24 @@
+# Architecture — CxLLM-OS-APP
+
+> CxLLM OS shell application
+
+## Goals
+
+- Provide a focused, well-tested app-macos surface for the CxLLM family.
+- Stay deployable on its own (no monorepo coupling).
+- Keep the public ABI small and explicitly versioned.
+
+## Boundaries
+
+```text
+              +----------------------+
+   client --> |  CxLLM-OS-APP  |
+              +----------+-----------+
+                         |
+                         v
+                  CxLLM runtime / kernel
+```
+
+## Decisions
+
+- See `docs/adr/` for Architecture Decision Records.
diff --git a/docs/adr/0001-record-architecture-decisions.md b/docs/adr/0001-record-architecture-decisions.md
new file mode 100644
index 0000000..4fc033a
--- /dev/null
+++ b/docs/adr/0001-record-architecture-decisions.md
@@ -0,0 +1,13 @@
+# 1. Record architecture decisions
+
+## Status
+Accepted
+
+## Context
+We need a lightweight, append-only log of architectural choices.
+
+## Decision
+Use Markdown ADRs in `docs/adr/`, numbered sequentially.
+
+## Consequences
+Future maintainers can read the chain of decisions without spelunking PR history.