A personal AI agent for your terminal, desktop, and phone.
pmai is a terminal agent that can work on code, run tools, research, and create documents. PocketMai brings the same Swift engine to native apps. Choose your model, keep conversations by project, and use your workstation from your phone.
Website · Releases · Documentation
- Your choice of model. Connect OpenAI-compatible services such as Ollama, llama.cpp, vLLM, and OpenRouter, sign in with ChatGPT, or run Apple Intelligence and MLX locally on supported Apple hardware.
- Your workstation on your phone. Share projects, chats, files, and terminals over encrypted Iroh connections through built-in Forwiroh. Pair with a QR code and approve access on the host; no separate tunnel command is needed.
- Project boxes. Run agents and their tools in Docker or Podman containers with a separate Git checkout. Review the diff and explicitly apply changes back to your project.
- Tools and agents you control. Use skills, MCP tools, ACP agents, and subagents with their own models and tools. Set approvals and run limits, or expose pmai itself to an ACP editor or MCP client.
- One workflow across devices. Keep project memory and todos, transfer chats with attachments and subagent history, use Vim and shell pipelines, or speak to PocketMai and build WebXDC mini apps in chat.
| Interface | Platforms | Get it |
|---|---|---|
| pmai CLI | macOS, Linux, Windows (beta), Android/Termux | Install below · CLI guide |
| pmai for Mac | Native macOS app | Releases · Build guide |
| PocketMai for iOS | iPhone and iPad, iOS 18+ | App Store |
| PocketMai for Android | Native Kotlin/Compose app, arm64 | Download APK · Android guide |
Local models and device features depend on OS and hardware support. See the feature guide and build requirements.
macOS, Linux, or Android/Termux:
curl -fsSL https://raw.githubusercontent.com/trufae/pmai/main/www/install.sh | shWindows (PowerShell):
irm https://raw.githubusercontent.com/trufae/pmai/main/www/install.ps1 | iexThe installers verify checksums and need no administrator privileges. Update
with pmai -U. Run pmai to configure a provider and choose a model; see
getting started for Ollama, ChatGPT, and other providers.
Run a prompt with your configured model, from a project directory:
pmai "explain this project"Serve this project over Iroh. Enter this inside the pmai REPL, then scan the
QR in PocketMai's Hosts screen and approve pairing on the host:
/remote serve --path .
Forwiroh is the default transport. See remote hosts for pairing, remote terminals, and LAN access.
Work in a project box from a Git checkout on macOS or Linux with Docker or Podman running:
pmai box create --share-home && pmai "review this project"--share-home shares your pmai settings, credentials, and chats with the box.
The box starts from committed HEAD; review with pmai box diff and import with
pmai box apply. See boxes for private homes and container options.
- Install, providers, and terminal setup · CLI reference
- Remote hosts and Iroh pairing · Project boxes
- Features · PocketMai voice, sharing, and CarPlay
- Build and releases · All documentation
Built on MaiCore, following MAI's terminal and Vim workflows.
—pancake
