
Poki nima?
Poki — AI agentiga iPhone'ni oddiy foydalanuvchi o‘zaro aloqasiga o‘xshash tarzda boshqarish imkonini beradigan, macOS va iOS uchun ochiq manbali loyiha. Uni Claude Code yoki Codex kabi MCP mijoziga ulashingiz yoki ixtiyoriy Poki Agent'dan terminal yoki xabar almashish kanali orqali foydalanishingiz mumkin.
Poki haqiqiy iPhone'ni boshqargani sababli, u muhim amallarni bajarishi mumkin. Undan xabar yuborish, to‘lovni amalga oshirish yoki hisobni o‘zgartirishni so‘rasangiz, bu amal amalda bajarilishi mumkin. Ekran tarkibi ham siz sozlagan model xizmatiga yuboriladi, shuning uchun loyihadan faqat maxfiylik va hisob bilan bog‘liq oqibatlarni tushungan holda foydalaning.
Loyiha yo‘l xaritasi va qo‘shimcha ma’lumot uchun Poki veb-saytiga tashrif buyuring.

Asosiy imkoniyatlar
- Poki MCP: Poki'ni Claude Code, Codex yoki MCP bilan mos keluvchi boshqa mijozga ulang.
- Poki Agent: Vazifalarni terminal yoki ruxsat berilgan iMessage va Telegram kanallaridan ishga tushiring.
- Qurilma tanlash: Bitta ulangan iPhone'dan avtomatik foydalaning yoki bir nechta qurilma mavjud bo‘lsa, UUID orqali qurilma tanlang.
- Takrorlash orqali o‘rganish: Poki avvalgi vazifalarni eslab qoladi va takroriy vazifalarni tezroq bajarishi mumkin.
- Bir nechta ulanish imkoniyati: Simulyator yoki Mac'ga ulangan haqiqiy iPhone'dan foydalaning.
- Ochiq manbali asos: Loyiha AGPL-3.0-only litsenziyasi ostida chiqarilgan.
Talablar
Manba kodidan o‘rnatish uchun macOS 15 yoki undan keyingi versiya, to‘liq Xcode, Rust, Node.js 24 yoki undan keyingi versiya hamda ffmpeg talab qilinadi. O‘rnatish skripti yetishmayotgan bog‘liqliklarni tekshiradi, ammo davom etishdan oldin u ko‘rsatgan barcha zarur komponentlarni o‘rnatishingiz kerak.
Haqiqiy iPhone uchun avval qurilmani USB orqali Mac bilan juftlang. USB orqali juftlash, Developer Mode va Wi-Fi tafsilotlari uchun loyihaning haqiqiy iPhone'ni sozlash qo‘llanmasiga amal qiling.
Poki'ni manba kodidan o‘rnatish
Repozitoriyni klonlang, uning katalogiga kiring, o‘rnatish skriptini ishga tushiring va serverni boshlang:
git clone https://github.com/JosssphZhou/poki.git
cd poki
./bin/setup
npm startDastlabki yig‘ish bir necha daqiqa davom etishi mumkin. MCP serveri yoki Poki Agent'dan foydalanayotganingizda npm start ishga tushirilgan holda qolsin.
Tayyor macOS arm64 paketidan foydalanish
Apple Silicon Mac'dan foydalanayotgan bo‘lsangiz, loyiha relizlaridan poki-v0.1.1-macos-arm64.tar.gz faylini yuklab olishingiz mumkin. Uni ajrating, Node bog‘liqliklarini o‘rnating va serverni boshlang:
tar -xzf poki-v0.1.1-macos-arm64.tar.gz
cd poki-v0.1.1
npm ci --no-audit --no-fund
npm startPaket native bridge va idevice vositalarini o‘z ichiga oladi, shuning uchun Rust va ./bin/setup talab qilinmaydi. Shunga qaramay, sizga Apple Silicon qurilmasida ishlaydigan macOS, to‘liq Xcode, Node.js 24 yoki undan keyingi versiya, Python 3 va ffmpeg kerak bo‘ladi.
MCP mijozini ulash
Server ishga tushgach, xuddi shu katalogda boshqa terminal oching va Poki'ni MCP mijozingizga ro‘yxatdan o‘tkazing. Claude Code uchun quyidagidan foydalaning:

claude mcp add --scope user poki-mcp -- node "$PWD/src/stdio.mjs"Codex uchun:
codex mcp add poki-mcp -- node "$PWD/src/stdio.mjs"README shuningdek mcpServers JSON konfiguratsiyasini qabul qiladigan boshqa mijozlarni ham qo‘llab-quvvatlaydi. Mijozga xos tafsilotlar va muammolarni bartaraf etish bo‘yicha ma’lumot uchun loyihaning o‘rnatish qo‘llanmasini ko‘ring.
Poki Agent'ni o‘rnatish va tizimga kirish
Poki Agent ixtiyoriy hisoblanadi. U mustaqil terminal agentini taqdim etadi va sozlangan xabar almashish kanallarini qo‘llab-quvvatlaydi. Poki serverini ishga tushirilgan holda qoldiring, so‘ng loyiha katalogida boshqa terminal ochib, agentni o‘rnating:
npm ci --prefix agent
export PATH="$PWD/bin:$PATH"
poki login
poki statusPoki Agent sukut bo‘yicha past darajadagi reasoning bilan gpt-6.1-terra modelidan foydalanadi. README ushbu standart sozlamani saqlashni tavsiya qiladi, chunki u telefon vazifalari uchun sinovdan o‘tkazilgan eng tezkor sozlama bo‘lgan. Modelni almashtirish uchun POKI_AGENT_MODEL muhit o‘zgaruvchisini belgilang. Qo‘llab-quvvatlanadigan konfiguratsiya uchun Poki Agent'ni ishga tushirish qo‘llanmasini ko‘ring.
Birinchi iPhone vazifangizni bajaring
Bitta iPhone ulanganda, Poki Agent uni avtomatik tanlaydi. Ulangan qurilmalar va ularning UUID'larini ko‘rish uchun quyidagini ishga tushiring:
node bin/call.mjs list_devicesShundan so‘ng agentdan vazifani bajarishni so‘rashingiz mumkin. Masalan:
poki "Search esp32 in Chrome and summarize the top result"Agar bir nechta qurilma ulangan bo‘lsa, UUID orqali maqsadli qurilmani ko‘rsating:
poki --device '<device UUID>' "Search esp32 in Chrome and summarize the top result"To‘g‘ri qurilma, ilova va model konfiguratsiyasidan foydalanilayotganini tekshirayotgan paytingizda xavfi past vazifalardan boshlang.
Xabar almashish kanallaridan foydalanish
Ruxsat berilgan kanalni sozlaganingizdan so‘ng, iMessage yoki Telegram uchun Poki Agent'ni ishga tushirishingiz mumkin:
poki imessage
poki telegram
Kanalni sozlash va model konfiguratsiyasi Poki Agent hujjatlarida bayon qilingan. Agentingizga kim vazifa yuborishi va bu vazifalar qanday amallarni ishga tushirishi mumkinligini tushunmaguningizcha, kanalga ruxsat bermang.

Kengaytirilgan konfiguratsiya va texnik xizmat
Poki'ni yangilash
Loyiha katalogidan o‘rnatilgan yangilash buyrug‘idan foydalaning:
./bin/poki updatePoki har kuni GitHub relizlarini anonim tarzda tekshiradi. Ushbu tekshiruvni o‘chirish uchun quyidagini belgilang:
export POKI_NO_UPDATE_CHECK=1Yangilagandan so‘ng, qayta ishga tushirish bosqichlari va oldindan tuzilgan paket tafsilotlari uchun loyihaning yangilash yo‘riqnomasiga amal qiling.
To‘g‘ri qurilmani tanlang
Vazifani boshlashdan oldin mavjud qurilmalarni tasdiqlash kerak bo‘lsa, node bin/call.mjs list_devices buyrug‘idan foydalaning. Bir nechta qurilma mavjud bo‘lsa, avtomatik tanlashga tayanish o‘rniga aniq UUID’ni --device orqali kiriting.
Jismoniy iPhone cheklovlarini tushuning
Jismoniy iPhone qo‘llab-quvvatlashi faqat xitoycha interfeysdan foydalanadigan iPhone’larda tekshirilgan. Jismoniy qurilmalar faqat portret yo‘nalishini qo‘llab-quvvatlaydi. Ilova konteynerini eksport qilish va Sozlamalar ichki sahifalariga to‘g‘ridan-to‘g‘ri havolalar mavjud emas. Ish jarayonini jismoniy qurilma asosida loyihalashdan oldin loyihaning tekshiruv va ma’lum cheklovlarini ko‘rib chiqing.
Asboblar va konfiguratsiya ma’lumotnomalarini o‘rganing
Chuqurroq integratsiyalar uchun MCP asboblari ishlashi ma’lumotnomasi va konfiguratsiya qo‘llanmasini o‘qing. Bu hujjatlarda asboblarning ishlashi, muhit o‘zgaruvchilari va sessiyalar yoritilgan. Repozitoriyda shuningdek native ko‘prik va simulyator adapteri hujjatlashtirilgan.
Xavfsizlik va litsenziyalash
Poki haqiqiy iPhone’ingizni boshqaradi. Siz so‘rasangiz, xabar yuborish yoki to‘lovlarni amalga oshirish kabi amallar bajarilishi mumkin.
Poki mustaqil ochiq kodli loyiha bo‘lib, Apple, OpenAI yoki u boshqaradigan ilovalar va veb-saytlar ishlab chiqaruvchilari bilan bog‘liq emas. Uchinchi tomon xizmatlarini avtomatlashtirish ularning xizmat ko‘rsatish shartlarini buzishi mumkin; qurilmangiz va hisoblaringizda bajarilgan amallar uchun siz javobgarsiz. Dastur AGPL-3.0-only litsenziyasi asosida mavjud holicha taqdim etiladi.
Xulosa
Poki macOS’dan iPhone’ga AI vositalarini ulashning amaliy usulini taqdim etadi. Uni manba kodidan o‘rnating yoki Apple Silicon paketidan foydalaning, serverni ishga tushirilgan holda saqlang, MCP endpoint’ini mijozingizda ro‘yxatdan o‘tkazing va terminal yoki xabar almashish jarayonlari uchun Poki Agent’dan foydalaning. Nazorat qilinadigan vazifalardan boshlang, zarur bo‘lganda qurilmalarni aniq tanlang va kengroq avtomatlashtirishni yoqishdan oldin loyiha cheklovlari hamda xavfsizlik yo‘riqnomalarini ko‘rib chiqing.
