Skip to content
trufaePublic

About

Your Pocket Assistant for iOS, Android, and commandline harness for Linux, macOS and Windows written in pure Swift

Resources

Stars

10 stars

Watchers

1 watching

Forks

Latest commit

 

History

1,735 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CI

PocketMai logo

pmai + PocketMai

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.

Platforms

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.

Install

macOS, Linux, or Android/Termux:

curl -fsSL https://raw.githubusercontent.com/trufae/pmai/main/www/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/trufae/pmai/main/www/install.ps1 | iex

The 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.

Three quick commands

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.

Learn more

Built on MaiCore, following MAI's terminal and Vim workflows.

—pancake

About

Your Pocket Assistant for iOS, Android, and commandline harness for Linux, macOS and Windows written in pure Swift

Resources

Stars

10 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages