منصوبے کے بارے میں

pixelpets ونڈوز 10/11 کے لیے ایک Electron ڈیسک ٹاپ ساتھی ہے، جس کا macOS 12+ بیٹا پورٹ بھی موجود ہے (کوڈ مکمل ہے اور ad-hoc سائنڈ ہے، لیکن README کے مطابق اسے ابھی تک اصل ایپل ہارڈ ویئر پر نہیں چلایا گیا)۔ Linux واضح طور پر اس کے لیے سپورٹڈ نہیں ہے: اوورلے اور گلوبل ان پٹ ہکس صرف Windows/macOS کے لیے ہیں۔ آپ پہلے سے تیار شدہ ونڈوز انسٹالر انسٹال کر سکتے ہیں یا git، Node 20 یا اس سے نئے ورژن، اور `npm install` / `npm start` کے ساتھ سورس سے چلا سکتے ہیں؛ ایک براؤزر ڈیمو وہی رینڈرر چلاتا ہے جس کے لیے کچھ بھی انسٹال کرنے کی ضرورت نہیں ہوتی۔ بلڈز غیر دستخط شدہ (unsigned) ہیں، اس لیے ونڈوز SmartScreen اور macOS Gatekeeper پہلی بار لانچ کرنے پر وارننگ دیں گے، اور انسٹالیشن خود کو لاگ ان پر شروع ہونے کے لیے رجسٹر کرتی ہے (`npm run autostart:off` اسے غیر فعال کرتا ہے)۔ یہ کیا کرتا ہے پیٹ ہر دوسری ونڈو کے اوپر ایک شفاف، کلک-تھرو اوورلے میں رہتا ہے؛ صرف پیٹ خود کلک کے قابل ہے۔ یہ پیار کرنے، ڈریگ کرنے، ٹائپنگ، اسکرولنگ اور کرسر کے کھیل پر ردعمل دیتا ہے، جس کے جوابات ایک اندرونی موڈ ماڈل کے ذریعے کنٹرول ہوتے ہیں جو پرسکون حالت سے لے کر انتہائی پرجوش (zoomies) تک چلتا ہے۔ ڈریگ کرنے سے یہ کھنچتا ہے اور چھوڑنے کا مقام نچلی لائن پر اس کا نیا گھر بن جاتا ہے۔ رائٹ کلک کرنے سے اس کے کوٹس (coats) تبدیل ہوتے ہیں؛ ٹیپ کرنے سے خوشی والی آنکھیں، دل اور چہچہاہٹ پیدا ہوتی ہے؛ اس کے سر یا جسم پر کرسر رکھنے سے پیار کرنے کے مختلف ردعمل ملتے ہیں۔ کہیں بھی ٹائپ کرنے سے سامنے کے پنجوں کی مالش (kneading) شروع ہو جاتی ہے (تیز ٹائپنگ اسے اوور ہیٹ کر دیتی ہے)، اور اسکرولنگ اسے پینٹ آرٹ والے کوٹس پر پتے پر جھپٹنے یا اون کے رسی پر چڑھنے پر اکساتی ہے۔ ایک ٹرے آئیکن سیٹنگز، بریک اسٹارٹ، کوٹ کا انتخاب، پلے ایریا، ساؤنڈ/ہنٹ/موڈ ٹوگلز اور کوئٹ (quit) کی سہولت فراہم کرتا ہے۔ بصری اور آڈیو ایپ 14 بلیوں کے کوٹس اور ایک بلیک لیب (کتا) فراہم کرتی ہے، جن سب کو ڈرا ٹائم پر ایک ہی رول-کوڈڈ اسپرائٹ سے دوبارہ رنگ کیا جاتا ہے۔ اینیمیشنز، بشمول اعضاء، اسی اسپرائٹ میں ترتیب دیے گئے ہیں، لہذا ہر کوٹ اور دونوں انواع کو اضافی امیج فائلوں کے بغیر اپنے رنگوں میں ہر پوز مل جاتا ہے۔ صارفین کوٹس ڈیزائن، امپورٹ اور ایکسپورٹ کر سکتے ہیں۔ اس میں کوئی آڈیو فائلیں نہیں ہیں: میاؤں، بھونکنا، غراہٹ، ہانپنا اور ایک امپروائزنگ lo-fi میوزک لوپ Web Audio کے ذریعے لائیو سنتھیسائز کیے جاتے ہیں۔ پروڈکٹیویٹی فیچرز پیٹ کے رویوں کے علاوہ، یہ بریک اور Pomodoro ٹائمرز، بار بار آنے والے ریمائنڈرز، ایک پن شدہ نوٹ، IMAP ان ریڈ میل الرٹس اور کیلنڈر نوٹیفیکیشنز فراہم کرتا ہے۔ Focus Guard لائیو کیلنڈر ایونٹ، Quiet Hours یا Work موڈ سے "busy" حالت کو پڑھتا ہے، پیٹ کو پارک کر دیتا ہے اور اسکرین شیئرنگ کے دوران مداخلت کرنے کے بجائے پیغامات کو روک لیتا ہے؛ فارغ ہونے پر روکے گئے پیغامات کا ایک لائن میں خلاصہ پیش کیا جاتا ہے۔ سیٹنگز صارف کے ایپ-ڈیٹا فولڈر میں `settings.json` میں محفوظ رہتی ہیں، اور پروجیکٹ کے نام کی تبدیلی سے پہلے کی انسٹالیشنز کو مائگریٹ کر دیا جاتا ہے۔ ٹائمرز اور ریمائنڈرز صرف اس وقت چلتے ہیں جب ایپ چل رہی ہو اور مقامی گھڑی کا استعمال کرتے ہیں۔ AI ایجنٹ انٹیگریشن pixelpets کوڈنگ ایجنٹ کی کام کی حالت پر ردعمل دے سکتا ہے: جب ایجنٹ سوچتا ہے تو یہ اپنے ٹھوڑی پر پنجہ رکھ کر غور کرتا ہے، جب وہ کام کرتا ہے تو اسپنر کے ساتھ ٹیپ کرتا ہے، غلطیوں پر چونکتا ہے، اور جب ایجنٹ کام مکمل کر لیتا ہے تو اچھلتا اور میاؤں کرتا ہے۔ کوئی بھی ٹول `agent-hook.js` کو thinking، editing، error، done یا idle جیسی حالت کے ساتھ چلا کر اسے سگنل دے سکتا ہے، جو ایک چھوٹی اسٹیٹس فائل لکھتا ہے جس کی پیٹ نگرانی کرتا ہے۔ Claude Code، Codex CLI، Cursor، Antigravity اور Kiro کے لیے تیار شدہ کنفیگز موجود ہیں، اور ہیلپر hook-safe ہے: یہ stdin کو خالی کرتا ہے اور `{"continue": true}` کا جواب دیتا ہے تاکہ یہ ایجنٹ کو بلاک یا تبدیل نہ کرے۔ پرائیویسی چونکہ یہ ٹائپنگ اور اسکرولنگ پر ردعمل دیتا ہے، ایپ گلوبل ان پٹ ایونٹس کو سنتی ہے۔ README میں بتایا گیا ہے کہ ان پٹ کا استعمال صرف آپ کی مشین پر اسی لمحے اینیمیشنز کو متحرک کرنے کے لیے کیا جاتا ہے: کی اسٹروکس کبھی لاگ، اسٹور یا منتقل نہیں کیے جاتے۔ کوئی ٹیلی میٹری نہیں ہے اور کوئی آٹو اپ ڈیٹ نہیں ہے، اور کوئی نیٹ ورک کنکشن نہیں ہے جب تک کہ آپ اختیاری میل یا کیلنڈر الرٹس ترتیب نہ دیں، جو صرف ان سرورز سے بات کرتے ہیں جنہیں آپ الگ تھلگ ورکر پراسیسز سے متعین کرتے ہیں۔ IMAP ایپ پاس ورڈز `settings.json` کے بجائے Electron `safeStorage` کا استعمال کرتے ہوئے انکرپٹڈ حالت میں محفوظ کیے جاتے ہیں۔ ترقی اور دستاویزات دستاویزات میں فیچرز، کسٹم کوٹس، آرکیٹیکچر، ڈویلپمنٹ گائیڈ، ہاتھ سے پینٹ کرنے اور پوز امپورٹ کرنے کے لیے فریم پیک، ایجنٹ ہکس، اور ایک چھوٹا iPad ٹرمینل ٹول شامل ہے۔ `npm test` بغیر Electron یا GPU کےTestSuite چلاتا ہے، `npm run lint` وہی کرتا ہے جو CI ایک بوٹ چیک کے ساتھ چلاتا ہے، `npm run poses:cat` بصری QA کے لیے ہر کوٹ میں ہر سرگرمی کی کانٹیکٹ شیٹس تیار کرتا ہے، اور `npm run demo:all` README میڈیا کو دوبارہ تیار کرتا ہے۔ چونکہ اوورلے GPU-کمپوزٹڈ ہے، عام اسکرین شاٹس اسے کیپچر نہیں کر سکتے، اس لیے بصری جائزہ ان کانٹیکٹ شیٹس پر منحصر ہے۔ پروجیکٹ MIT لائسنس کے تحت ہے؛ آرٹ، کوڈ اور ساؤنڈ کو اصل (original) بتایا گیا ہے، اور یہ دو اوپن سورس ڈیسک ٹاپ پیٹس کو بطور تحریک ذکر کرتا ہے جبکہ یہ واضح کرتا ہے کہ کسی تیسرے فریق کے اثاثے، اسپرائٹس، آڈیو یا برانڈنگ استعمال نہیں کی گئی ہے۔ شراکت داری (Contributions) کا خیرمقدم ہے، جس میں ایک کنٹری بیوٹنگ گائیڈ، ایک نجی سیکیورٹی رپورٹنگ پالیسی، کسٹم کوٹس اور ڈیسک سیٹ اپ کے لیے مباحثے، اور میک مالکان کے لیے ایک بیٹا چیک لسٹ شامل ہے جسے موجودہ سب سے مفید شراکت قرار دیا گیا ہے۔