Poki استعمال کرتے ہوئے AI سے iPhone کنٹرول کریں: سیٹ اپ، MCP اور ایجنٹ ورک فلو

پوکِی کیا ہے؟

پوکِی ایک اوپن سورس macOS اور iOS پروجیکٹ ہے جو ایک AI ایجنٹ کو iPhone اس طرح چلانے دیتا ہے جیسے عام صارف تعامل کر رہا ہو۔ آپ اسے Claude Code یا Codex جیسے MCP کلائنٹ سے منسلک کر سکتے ہیں، یا اختیاری Poki Agent کو ٹرمینل یا پیغام رسانی کے چینل سے استعمال کر سکتے ہیں۔

چونکہ پوکِی ایک حقیقی iPhone کو کنٹرول کرتا ہے، اس لیے یہ اہم کارروائیاں انجام دے سکتا ہے۔ اگر آپ اسے پیغام بھیجنے، ادائیگی کرنے یا کسی اکاؤنٹ میں ترمیم کرنے کو کہیں، تو یہ کارروائی واقعی ہو سکتی ہے۔ اسکرین کا مواد آپ کی تشکیل کردہ ماڈل سروس کو بھی بھیجا جاتا ہے، اس لیے پروجیکٹ صرف اسی وقت استعمال کریں جب آپ رازداری اور اکاؤنٹ سے متعلق مضمرات کو سمجھتے ہوں۔

پوکِی کی ویب سائٹ دیکھیں جہاں پروجیکٹ کا روڈمیپ اور مزید معلومات موجود ہیں۔

اہم خصوصیات

• Poki MCP: پوکِی کو Claude Code، Codex یا کسی دوسرے MCP سے مطابقت رکھنے والے کلائنٹ سے منسلک کریں۔
• Poki Agent: ٹرمینل یا مجاز iMessage اور Telegram چینلز سے کام چلائیں۔
• ڈیوائس کا انتخاب: خودکار طور پر ایک منسلک iPhone استعمال کریں یا متعدد دستیاب ڈیوائسز میں سے UUID کے ذریعے ڈیوائس منتخب کریں۔
• تکرار سے سیکھنا: پوکِی سابقہ کام یاد رکھتا ہے اور دہرائے جانے والے کام زیادہ تیزی سے چلا سکتا ہے۔
• کنکشن کے متعدد اختیارات: سمیولیٹر یا Mac سے منسلک حقیقی iPhone استعمال کریں۔
• اوپن سورس بنیاد: یہ پروجیکٹ AGPL-3.0-only لائسنس کے تحت جاری کیا گیا ہے۔

ضروریات

سورس سے انسٹالیشن کے لیے macOS 15 یا بعد کا ورژن، مکمل Xcode، Rust، Node.js 24 یا بعد کا ورژن، اور ffmpeg درکار ہیں۔ سیٹ اپ اسکرپٹ غائب dependencies کی جانچ کرتا ہے، لیکن جاری رکھنے سے پہلے آپ کو بتائی گئی prerequisites انسٹال کرنا ہوں گی۔

حقیقی iPhone کے لیے پہلے USB کے ذریعے ڈیوائس کو اپنے Mac کے ساتھ pair کریں۔ USB pairing، Developer Mode اور Wi-Fi کی تفصیلات کے لیے پروجیکٹ کی حقیقی iPhone سیٹ اپ گائیڈ پر عمل کریں۔

سورس سے پوکِی انسٹال کریں

repository clone کریں، اس کی ڈائریکٹری میں جائیں، سیٹ اپ اسکرپٹ چلائیں اور سرور شروع کریں:

git clone https://github.com/JosssphZhou/poki.git
cd poki
./bin/setup
npm start

ابتدائی build میں چند منٹ لگ سکتے ہیں۔ MCP سرور یا Poki Agent استعمال کرتے وقت npm start کو چلتا رہنے دیں۔

پہلے سے تیار macOS arm64 پیکیج استعمال کریں

اگر آپ Apple Silicon Mac استعمال کر رہے ہیں تو پروجیکٹ کی releases سے poki-v0.1.1-macos-arm64.tar.gz ڈاؤن لوڈ کر سکتے ہیں۔ اسے extract کریں، Node dependencies انسٹال کریں اور سرور شروع کریں:

tar -xzf poki-v0.1.1-macos-arm64.tar.gz
cd poki-v0.1.1
npm ci --no-audit --no-fund
npm start

اس پیکیج میں native bridge اور idevice tools شامل ہیں، اس لیے Rust اور ./bin/setup درکار نہیں ہیں۔ پھر بھی آپ کو Apple Silicon پر macOS، مکمل Xcode، Node.js 24 یا بعد کا ورژن، Python 3 اور ffmpeg درکار ہوں گے۔

MCP کلائنٹ منسلک کریں

سرور چلنے کے بعد اسی ڈائریکٹری میں ایک اور ٹرمینل کھولیں اور اپنے MCP کلائنٹ میں پوکِی رجسٹر کریں۔ Claude Code کے لیے یہ کمانڈ استعمال کریں:

claude mcp add --scope user poki-mcp -- node "$PWD/src/stdio.mjs"

Codex کے لیے یہ کمانڈ استعمال کریں:

codex mcp add poki-mcp -- node "$PWD/src/stdio.mjs"

README ایسے دیگر کلائنٹس کو بھی سپورٹ کرتا ہے جو mcpServers JSON configuration قبول کرتے ہیں۔ کلائنٹ سے متعلق تفصیلات اور troubleshooting کے لیے پروجیکٹ کی انسٹالیشن گائیڈ دیکھیں۔

Poki Agent انسٹال کریں اور سائن اِن کریں

Poki Agent اختیاری ہے۔ یہ ایک standalone ٹرمینل ایجنٹ فراہم کرتا ہے اور تشکیل کردہ پیغام رسانی کے چینلز کو سپورٹ کرتا ہے۔ Poki سرور کو چلتا رہنے دیں، پھر پروجیکٹ ڈائریکٹری میں ایک اور ٹرمینل کھولیں اور ایجنٹ انسٹال کریں:

npm ci --prefix agent
export PATH="$PWD/bin:$PATH"
poki login
poki status

Poki Agent بطور ڈیفالٹ کم reasoning کے ساتھ gpt-6.1-terra استعمال کرتا ہے۔ README اس ڈیفالٹ کو برقرار رکھنے کی تجویز دیتا ہے کیونکہ فون کے کاموں کے لیے آزمائے گئے سیٹ اپ میں یہ سب سے تیز تھا۔ ماڈل تبدیل کرنے کے لیے POKI_AGENT_MODEL environment variable سیٹ کریں۔ معاون configuration کے لیے Run Poki Agent گائیڈ دیکھیں۔

اپنا پہلا iPhone کام چلائیں

جب ایک iPhone منسلک ہو تو Poki Agent اسے خودکار طور پر منتخب کرتا ہے۔ منسلک ڈیوائسز اور ان کے UUIDs دیکھنے کے لیے یہ کمانڈ چلائیں:

node bin/call.mjs list_devices

اس کے بعد آپ ایجنٹ سے کوئی کام انجام دینے کو کہہ سکتے ہیں۔ مثال کے طور پر:

poki "Search esp32 in Chrome and summarize the top result"

اگر ایک سے زیادہ ڈیوائسز منسلک ہوں تو UUID کے ذریعے ہدف ڈیوائس بتائیں:

poki --device '<device UUID>' "Search esp32 in Chrome and summarize the top result"

کم خطرے والے کاموں سے شروع کریں اور تصدیق کریں کہ درست ڈیوائس، ایپ اور ماڈل configuration استعمال ہو رہی ہے۔

پیغام رسانی کے چینلز استعمال کریں

مجاز چینل تشکیل دینے کے بعد آپ iMessage یا Telegram کے لیے Poki Agent شروع کر سکتے ہیں:

poki imessage
poki telegram

چینل سیٹ اپ اور ماڈل configuration کی تفصیلات Poki Agent documentation میں موجود ہیں۔ کسی چینل کو اس وقت تک مجاز نہ بنائیں جب تک آپ یہ نہ سمجھ لیں کہ آپ کے ایجنٹ کو کام کون بھیج سکتا ہے اور ان کاموں سے کون سی کارروائیاں شروع ہو سکتی ہیں۔

اعلیٰ درجے کی configuration اور دیکھ بھال

پوکِی اپ ڈیٹ کریں

پروجیکٹ ڈائریکٹری سے built-in update command استعمال کریں:

./bin/poki update

پوکِی روزانہ گمنام GitHub release check کرتا ہے۔ یہ جانچ غیر فعال کرنے کے لیے سیٹ کریں:

export POKI_NO_UPDATE_CHECK=1

اپ ڈیٹ کرنے کے بعد، دوبارہ شروع کرنے کے مراحل اور پہلے سے تیار کردہ پیکیج کی تفصیلات کے لیے پروجیکٹ کی اپ ڈیٹ ہدایات پر عمل کریں۔

درست ڈیوائس منتخب کریں

جب آپ کو دستیاب ڈیوائسز کی تصدیق کرنی ہو تو کام شروع کرنے سے پہلے node bin/call.mjs list_devices استعمال کریں۔ متعدد ڈیوائسز کی صورت میں خودکار انتخاب پر انحصار کرنے کے بجائے --device کے ساتھ عین UUID فراہم کریں۔

فزیکل آئی فون کی حدود سمجھیں

فزیکل آئی فون سپورٹ کی تصدیق صرف چینی انٹرفیس استعمال کرنے والے آئی فونز پر ہوئی ہے۔ فزیکل ڈیوائسز صرف پورٹریٹ سمت کو سپورٹ کرتی ہیں۔ ایپ کنٹینر ایکسپورٹ اور سیٹنگز کے ذیلی صفحات کے براہِ راست لنکس دستیاب نہیں ہیں۔ فزیکل ڈیوائس کے گرد ورک فلو ڈیزائن کرنے سے پہلے پروجیکٹ کی تصدیق اور معلوم حدود کا جائزہ لیں۔

ٹول اور کنفیگریشن کے حوالہ جات دیکھیں

مزید گہری انٹیگریشنز کے لیے MCP ٹول کے رویے کا حوالہ اور کنفیگریشن گائیڈ پڑھیں۔ یہ دستاویزات ٹول کے رویے، ماحول کے متغیرات اور سیشنز کا احاطہ کرتی ہیں۔ ریپوزٹری اپنے نیٹو برج اور سیمیولیٹر اڈاپٹر کی بھی دستاویز فراہم کرتی ہے۔

حفاظت اور لائسنسنگ

Poki آپ کے حقیقی آئی فون کو کنٹرول کرتا ہے۔ اگر آپ کہیں تو پیغامات بھیجنے یا ادائیگیاں کرنے جیسے اقدامات انجام پا سکتے ہیں۔

Poki ایک آزاد اوپن سورس پروجیکٹ ہے اور اس کا Apple، OpenAI، یا ان ایپس اور ویب سائٹس کے سازندگان سے کوئی تعلق نہیں جنہیں یہ چلاتا ہے۔ تھرڈ پارٹی سروسز کو خودکار بنانا ان کی سروس کی شرائط کی خلاف ورزی ہو سکتا ہے، اور آپ اپنے ڈیوائس اور اکاؤنٹس پر کیے گئے اقدامات کے ذمہ دار ہیں۔ یہ سافٹ ویئر AGPL-3.0-only لائسنس کے تحت موجودہ حالت میں فراہم کیا جاتا ہے۔

نتیجہ

Poki macOS سے AI ٹولز کو آئی فون سے منسلک کرنے کا ایک عملی طریقہ فراہم کرتا ہے۔ اسے سورس سے انسٹال کریں یا Apple Silicon پیکیج استعمال کریں، سرور کو چلتا رکھیں، MCP اینڈ پوائنٹ کو اپنے کلائنٹ کے ساتھ رجسٹر کریں، اور ٹرمینل یا پیغام رسانی کے ورک فلو کے لیے Poki Agent استعمال کریں۔ محدود اور قابو میں رکھے گئے کاموں سے آغاز کریں، ضرورت پڑنے پر ڈیوائسز واضح طور پر منتخب کریں، اور وسیع تر آٹومیشن فعال کرنے سے پہلے پروجیکٹ کی حدود اور حفاظتی رہنمائی کا جائزہ لیں۔