$ cat ~/map/pi-client.md

Pi Client

Flutter client for pi — one codebase reaching Android, iOS, macOS, Windows, Linux, and Web.

tools✓ Sep 2

brew install --cask hu-wentao/tap/pi-client

## TL;DR

An independent Flutter client for the pi coding agent — one codebase targets Android, iOS, macOS, Windows, Linux, and Web, with mobile and Web as connect-only clients and the desktop host runtime still under development.

## Key points

• $One Flutter project targets Android, iOS, macOS, Windows, Linux, and Web, with a tested PlatformCapabilities contract separating desktop host-capable from mobile/Web connect-only roles.
• $Android, iOS, and Web are connect-only clients: they attach to a remote agent host and must not embed the Agent runtime, launch host tools, or obtain host filesystem authority.
• $Desktop platforms are host-capable by contract — an execution role, not evidence that a host runtime ships in current public builds; the independent runtime and transport are under active development.
• $Current Preview builds are evaluation artifacts using a transitional pi-web compatibility boundary, and the Preview requires a reachable pi-web 0.8.11 service.
• $The unsigned, un-notarized macOS Preview (macOS 11 or newer) installs via the project-owned Homebrew cask; on first launch, Control-click the app in Finder and choose Open, since Gatekeeper blocks a normal first open.

## FAQ

## References

• README ↗

Last updated: Sep 2, 2026