Compatibility

Back to the overview

What runs where. Other pages link here instead of repeating requirements.

Platforms

PartLinuxmacOSWindows
CLI, MCP server, pmcp project, hooksyesyesnot qualified
pmcp tui and harness groupsx64 and arm64, glibc 2.35 or later, user systemdx64 and arm64, sessions uncappednot supported
pmcp harness host up and host unituser systemd manager requiredrefusednot supported
pmcp-browser and pmcp-desktopx64 and arm64, glibc 2.35 or laternot shippednot shipped

All of them need Node.js 22 or later, or Bun 1.3 or later. npm installs pmcp-pty, pmcp-tui and (on Linux) the two plugin binaries through a platform package, @modootoday/pmcp-<os>-<cpu>. PMCP_PTY_BIN and PMCP_TUI_BIN point at other builds. On Linux a user systemd manager caps each native session's memory; macOS runs sessions without that cap. The macOS binaries are unsigned; installed through npm they run as they are, since npm sets no quarantine flag.

Native runtimes

Runtime[targets] toolspmcp tui and harness id[[host.sessions]] runtime
Claude Codeclaudeclaude-codeclaude
Codexcodexcodex-clicodex
Gemini CLIgeminigemini-cligemini
Grok Buildgrokgrok-cligrok
Antigravity (agy)antigravityantigravityagy
OpenCodeopencodenot availableopencode

Which hook features each runtime supports, as measured, is in Runtime support. Provider login, folder trust and tool approvals stay in each runtime; pmcp never answers login, auth, trust or hook-review prompts.

Installation and packaging

SurfaceCurrent qualification
CLI and MCP on Linux amd64Published 0.15.0 passed clean Docker installation with npm on Debian/Alpine and Bun/pnpm on Debian; 60 installation and failure contracts
Optional terminal workspaceLinux pmcp-pty checks and a native Claude main with a Gemini worker (control, input, wake turns, recovery); other runtimes measured on tmux in 0.17
Public skill installationnpm, Bun and pnpm 10.17.1; confirmation required, scripts disabled
Native plugin exportClaude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin
pnpm workspace installationSelects the member, preserves root dependencies and updates the shared lockfile
Yarn skill installationRefused without changing project files; Yarn PnP is not supported
Docker profile for the harnessCodex 0.161.0 login and main/worker responses through the profile's proxy; other vendors and token refresh not measured
OpenCode user-only skillsOpenCode 1.18.33: invocation = "user" hides the skill from the model and keeps the /<name> command, measured with isolated CLI calls and scripted responses, no model call

Provider authentication, native children and vendor behavior have separate qualification scopes. An installed executable or exported manifest is not proof that every native feature works. The packed-package check, run before a release, covers actual archive installation, CLI startup, MCP and SQLite; isolated projects on a host are distinct from Docker and OS qualification.