JosssphZhou/poki

选用指南

AI 根据 README 整理 · 2026/11/6 01:01:30

使用方式

通过命令行使用，可连接 Claude Code、Codex 等 MCP 客户端，或使用独立终端代理。

查看 README 依据

**Poki MCP.** Already using Claude Code, Codex, or another MCP client? Connect Poki MCP and use your own subscription. No extra model account needed. Start the server and keep it running: ```sh git clone https://github.com/JosssphZhou/poki.git cd poki ./bin/setup npm start ``` Requires macOS 15 or later, full Xcode, Rust, Node.js 24+, and ffmpeg. `./bin/setup` checks for missing dependencies. The initial build takes a few minutes. ### Prebuilt macOS arm64 package Download `poki-v0.1.0-macos-arm64.tar.gz` from the release and run: ```sh tar -xzf poki-v0.1.0-macos-arm64.tar.gz

**Poki Agent.** For Poki's standalone terminal agent or messaging channels, keep `npm start` running and open another terminal in the same directory. Install the agent, add its command to this terminal's path, and sign in: ```sh npm ci --prefix agent export PATH="$PWD/bin:$PATH" poki login poki status ``` For a physical iPhone, pair it with your Mac over USB first. See [Physical iPhone setup](docs/physical-iphone.md). ## Try a task With Poki Agent, one connected iPhone is selected automatically. With multiple devices, add `--device '<device UUID>'`. ```sh

部署要求

需要 macOS 15 或更高版本、完整 Xcode、Rust、Node.js 24+ 和 ffmpeg；预构建包仍需 Apple Silicon macOS、完整 Xcode、Node.js 24+、Python 3 和 ffmpeg。

查看 README 依据

**Poki MCP.** Already using Claude Code, Codex, or another MCP client? Connect Poki MCP and use your own subscription. No extra model account needed. Start the server and keep it running: ```sh git clone https://github.com/JosssphZhou/poki.git cd poki ./bin/setup npm start ``` Requires macOS 15 or later, full Xcode, Rust, Node.js 24+, and ffmpeg. `./bin/setup` checks for missing dependencies. The initial build takes a few minutes. ### Prebuilt macOS arm64 package Download `poki-v0.1.0-macos-arm64.tar.gz` from the release and run: ```sh tar -xzf poki-v0.1.0-macos-arm64.tar.gz

cd poki-v0.1.0 npm ci --no-audit --no-fund npm start ``` The package includes the native bridge and idevice tools. You do not need Rust or `./bin/setup`. You still need macOS on Apple Silicon, full Xcode, Node.js 24+, Python 3, and ffmpeg. Register your MCP client and install the optional Agent as described below. In another terminal, from the same directory, register the MCP server: ```sh claude mcp add --scope user poki-mcp -- node "$PWD/src/stdio.mjs" # Claude Code codex mcp add poki-mcp -- node "$PWD/src/stdio.mjs" # Codex ```

已知限制

物理 iPhone 支持仅在中文界面设备上验证，仅支持竖屏，且不支持应用容器导出和设置子页面直接链接。

查看 README 依据

**MCP clients:** Claude Code, Codex, and any client supporting `mcpServers` JSON. Physical iPhone support has been verified only on iPhones using the Chinese interface. Physical devices support portrait orientation only. App container export and direct links to Settings subpages are unavailable. See [verification and known limits](docs/verification.md). ## Docs | Topic | Read | | --- | --- | | Installation, other MCP clients, and troubleshooting | [Install guide](docs/install.md) | | Poki Agent, models, iMessage, and Telegram | [Run Poki Agent](agent/README.md) |