khal-os 1.260405.1 → 1.260405.3

package/LICENSE

@@ -0,0 +1,45 @@
+Copyright (c) 2026 KhalOS. All rights reserved.
+
+PROPRIETARY SOFTWARE LICENSE
+
+This software and associated documentation files (the "Software") are the
+exclusive property of KhalOS. The Software is protected by copyright laws
+and international treaty provisions.
+
+1. GRANT OF LICENSE
+   No license is granted under this agreement. Access to this repository does
+   not constitute a license to use, copy, modify, or distribute the Software.
+
+2. RESTRICTIONS
+   You may not, without prior written authorization from KhalOS:
+   a. Copy, reproduce, or duplicate the Software;
+   b. Modify, adapt, translate, or create derivative works of the Software;
+   c. Distribute, sublicense, lease, rent, loan, or otherwise transfer the
+      Software to any third party;
+   d. Reverse engineer, disassemble, decompile, or otherwise attempt to
+      derive the source code of the Software;
+   e. Remove, alter, or obscure any proprietary notices on the Software.
+
+3. CONFIDENTIALITY
+   The Software contains trade secrets and proprietary information of KhalOS.
+   You agree to maintain the confidentiality of the Software and not to
+   disclose it to any third party without prior written consent.
+
+4. OWNERSHIP
+   KhalOS retains all right, title, and interest in and to the Software,
+   including all intellectual property rights therein.
+
+5. TERMINATION
+   Any unauthorized use of the Software will result in immediate termination
+   of any implied rights and may result in legal action.
+
+6. NO WARRANTY
+   THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED. KHALOS DISCLAIMS ALL WARRANTIES, INCLUDING BUT NOT LIMITED TO THE
+   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+7. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL KHALOS BE LIABLE FOR ANY DAMAGES ARISING OUT OF THE USE
+   OR INABILITY TO USE THE SOFTWARE.
+
+For licensing inquiries, contact: legal@khal.ai

package/README.md

@@ -0,0 +1,38 @@
+# Khal
+
+A desktop-in-browser OS shell built with Next.js, React, and Tailwind CSS.
+
+## Quick Start
+
+```bash
+pnpm install
+pnpm dev          # Next.js on port 1111
+node pty-server.mjs  # PTY + WebSocket on port 1112
+```
+
+Open http://localhost:1111 to see the desktop.
+
+## Default Apps
+
+- **Terminal** — Full terminal emulator (xterm.js + node-pty)
+- **Settings** — Theme switcher and desktop configuration
+- **Files** — Example stub app (replace with your own)
+
+## Adding a New App
+
+1. Create a component in `src/components/apps/<your-app>/`
+   - Must accept `{ windowId: string; meta?: Record<string, unknown> }`
+2. Register in `src/components/apps/app-registry.ts`
+3. Add a `DesktopEntry` in `src/stores/desktop-store.ts`
+4. (Optional) Set default window size in `src/lib/hooks/use-launch-app.ts`
+5. (Optional) Add a keyboard shortcut in `src/lib/keyboard/defaults.ts`
+
+## Architecture
+
+- **Window Manager** — Draggable, resizable windows with snap, minimize, maximize
+- **Taskbar** — App launcher, running apps, system tray, workspace switcher
+- **Workspaces** — Virtual desktops
+- **Keyboard Shortcuts** — Configurable global hotkeys
+- **Notifications** — Toast + notification center
+- **PTY Server** — WebSocket-based terminal backend with session persistence
+- **Theme System** — Light/dark mode via CSS custom properties

package/package.json

@@ -1,9 +1,108 @@
 {
 	"name": "khal-os",
-	"version": "1.260405.1",
-	"description": "KhalOS CLI — manage, monitor, and deploy KhalOS instances. Coming soon.",
-	"bin": {"khal-os": "./cli.js"},
-	"files": ["cli.js"],
-	"license": "UNLICENSED",
-	"repository": {"type": "git", "url": "https://github.com/khal-os/core"}
+	"version": "1.260405.3",
+	"scripts": {
+		"dev": "next dev --port 8888",
+		"build": "npx tsx scripts/build-apps.ts && NEXT_PRIVATE_BUILD_WORKER=false next build",
+		"start": "next start --port 8888",
+		"postinstall": "chmod +x node_modules/.pnpm/node-pty@*/node_modules/node-pty/prebuilds/darwin-*/spawn-helper 2>/dev/null || true",
+		"pty-server": "node pty-server.mjs",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"knip": "knip",
+		"services": "tsx src/lib/service-loader.ts",
+		"tauri": "cd tauri && cargo run",
+		"tauri:dev": "cd tauri && cargo tauri dev",
+		"tauri:build": "cd tauri && cargo build --release",
+		"prepare": "husky"
+	},
+	"dependencies": {
+		"@json-render/core": "^0.7.0",
+		"@json-render/react": "^0.7.0",
+		"@khal-os/sdk": "^1.0.1",
+		"@khal-os/ui": "^1.0.1",
+		"@nats-io/jetstream": "^3.3.1",
+		"@nats-io/transport-node": "^3.3.1",
+		"@number-flow/react": "^0.6.0",
+		"@opentelemetry/core": "^2.6.1",
+		"@opentelemetry/instrumentation-http": "^0.214.0",
+		"@opentelemetry/instrumentation-pg": "^0.66.0",
+		"@opentelemetry/instrumentation-runtime-node": "^0.27.0",
+		"@opentelemetry/resources": "^2.6.1",
+		"@opentelemetry/sdk-metrics": "^2.6.1",
+		"@opentelemetry/sdk-node": "^0.214.0",
+		"@opentelemetry/semantic-conventions": "^1.40.0",
+		"@paper-design/shaders-react": "^0.0.72",
+		"@radix-ui/react-context-menu": "^2.2.16",
+		"@radix-ui/react-dialog": "^1.1.15",
+		"@radix-ui/react-dropdown-menu": "^2.1.16",
+		"@radix-ui/react-label": "^2.1.8",
+		"@radix-ui/react-separator": "^1.1.8",
+		"@radix-ui/react-slot": "^1.2.4",
+		"@radix-ui/react-switch": "^1.2.6",
+		"@radix-ui/react-tooltip": "^1.2.8",
+		"@sentry/nextjs": "^10.39.0",
+		"@sinclair/typebox": "^0.34.48",
+		"@tauri-apps/api": "^2.10.1",
+		"@temporalio/activity": "^1.15.0",
+		"@temporalio/client": "^1.15.0",
+		"@temporalio/worker": "^1.15.0",
+		"@temporalio/workflow": "^1.15.0",
+		"@types/archiver": "^7.0.0",
+		"@workos-inc/authkit-nextjs": "^2.14.0",
+		"@xterm/addon-fit": "^0.11.0",
+		"@xterm/addon-webgl": "^0.19.0",
+		"@xterm/xterm": "^6.0.0",
+		"archiver": "^7.0.1",
+		"class-variance-authority": "^0.7.1",
+		"clsx": "^2.1.1",
+		"cmdk": "^1.1.1",
+		"iron-session": "^8.0.4",
+		"jose": "^6.1.3",
+		"lucide-react": "^0.563.0",
+		"motion": "^12.38.0",
+		"next": "16.1.6",
+		"next-themes": "^0.4.6",
+		"node-pty": "^1.1.0",
+		"react": "19.2.3",
+		"react-dom": "19.2.3",
+		"tailwind-merge": "^3.4.0",
+		"ulidx": "^2.4.1",
+		"uuid": "^13.0.0",
+		"ws": "^8.20.0",
+		"zod": "^4.3.6",
+		"zustand": "^5.0.11"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.2",
+		"@commitlint/cli": "^20.5.0",
+		"@commitlint/config-conventional": "^20.5.0",
+		"@tailwindcss/postcss": "^4",
+		"@types/node": "^20",
+		"@types/react": "^19",
+		"@types/react-dom": "^19",
+		"@types/uuid": "^11.0.0",
+		"@types/ws": "^8.18.1",
+		"esbuild": "^0.27.4",
+		"git-cliff": "^2.12.0",
+		"husky": "^9.1.7",
+		"knip": "^5.85.0",
+		"tailwindcss": "^4",
+		"tsx": "^4.21.0",
+		"typescript": "^5"
+	},
+	"bin": {
+		"khal-os": "./packages/os-cli/dist/cli.js"
+	},
+	"files": [
+		"packages/os-cli/dist/"
+	],
+	"packageManager": "pnpm@10.28.2+sha512.41872f037ad22f7348e3b1debbaf7e867cfd448f2726d9cf74c08f19507c31d2c8e7a11525b983febc2df640b5438dee6023ebb1f84ed43cc2d654d2bc326264",
+	"pnpm": {
+		"onlyBuiltDependencies": [
+			"esbuild",
+			"node-pty",
+			"@sentry/cli"
+		]
+	}
 }