feat(clients): add Pi and OMP support

CHANGELOG.md

@@ -15,6 +15,14 @@
   **Migration**: Replace `pin:` with `ref:` in plugin objects and `--pin` with
   `--ref` in scripts. This is a clean cutover; the old names are not accepted.
 
+### Added
+
+- Pi and OMP as file-sync clients at project and user scope, including native
+  runtime skill paths and agent instructions.
+- Native Pi package and OMP marketplace-plugin lifecycle support for install,
+  update, uninstall, status, and list output, with fail-closed trust and
+  ownership checks.
+
 
 ## [1.0.0] - 2026-03-13
 

README.md

@@ -4,9 +4,9 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Docs](https://img.shields.io/badge/docs-allagents.dev-blue)](https://allagents.dev)
 
-Write AI agent skills once. Sync to 23 clients. Manage across multiple repos.
+Write AI agent skills once. Sync to 25 clients. Manage across multiple repos.
 
-AllAgents keeps your AI tooling (skills, agents, hooks, MCP servers) in one workspace and syncs it to every client your team uses — Claude, Copilot, Cursor, Codex, Gemini, and 18 more.
+AllAgents keeps your AI tooling (skills, agents, hooks, MCP servers) in one workspace and syncs it to every client your team uses — Claude, Copilot, Cursor, Codex, Gemini, and 20 more.
 
 ## Quick Start
 
@@ -55,7 +55,7 @@ Tools like `npx skills` and `npx plugins` install skills to one project for one
 | **Config** | Imperative | Imperative | Declarative (`workspace.yaml`) |
 | **Scope** | Single project | Single project | Multi-repo workspace |
 | **Artifacts** | Skills | Skills, agents, hooks, commands, MCP | Skills, agents, hooks, commands, MCP |
-| **Clients** | 43 agents | 2 (Claude, Cursor) | 23 clients simultaneously |
+| **Clients** | 43 agents | 2 (Claude, Cursor) | 25 clients simultaneously |
 | **Team sharing** | Each dev runs install | Each dev runs install | Git-versioned — clone and go |
 | **Ongoing sync** | One-shot install | One-shot install | `allagents update` keeps everything current |
 | **Workspace awareness** | None | None | WORKSPACE-RULES injected so AI knows all repos and skills |
@@ -106,11 +106,11 @@ See the [full CLI reference](https://allagents.dev/docs/reference/cli/) for all
 
 ## Supported Clients
 
-**23 AI coding assistants** across two tiers:
+**25 AI coding assistants** across two tiers:
 
 **Universal** (share `.agents/skills/`): Copilot, Codex, OpenCode, Gemini, Amp Code, VSCode, Replit, Kimi
 
-**Provider-specific**: Claude, Cursor, Factory, OpenClaw, Windsurf, Cline, Continue, Roo, Kilo, Trae, Augment, Zencoder, Junie, OpenHands, Kiro
+**Provider-specific**: Claude, Pi, OMP, Cursor, Factory, OpenClaw, Windsurf, Cline, Continue, Roo, Kilo, Trae, Augment, Zencoder, Junie, OpenHands, Kiro
 
 See the [client support matrix](https://allagents.dev/docs/reference/clients/) for paths, hooks, commands, and MCP support per client.
 

docs/src/content/docs/docs/index.mdx

@@ -16,7 +16,7 @@ AllAgents solves this by providing:
 | Feature | Claude Code Plugins | AllAgents |
 |---------|--------------------|-----------|
 | Scope | Single project | Multi-repo workspace |
-| Client support | Claude only | 8 AI clients |
+| Client support | Claude only | 25 AI clients |
 | File location | Runtime lookup from cache | Copied to workspace (git-versioned) |
 | Project structure | AI config mixed with code | Separate workspace repo |
 

docs/src/content/docs/docs/reference/cli.mdx

@@ -30,6 +30,12 @@ When `--scope user` is used, sync targets the user-level workspace at `~/.allage
 
 Sync state is tracked in `.allagents/sync-state.json`.
 
+For clients configured with native install mode, sync first inspects the real
+client inventory, then delegates only the required scoped install, update, or
+removal. Pi package and OMP marketplace-plugin effects are included in human and
+JSON output. Native state is tracked separately from copied files so AllAgents
+only removes resources whose ownership it can corroborate.
+
 When `vscode` is in the `clients` list, sync also generates a `.code-workspace` file with repository paths resolved to absolute paths. See the [Workspaces guide](/docs/guides/workspaces/#vscode-workspace-generation) for details.
 
 ### status
@@ -217,6 +223,12 @@ allagents plugin install superpowers@marketplace --skill brainstorming --skill t
 
 When used, all other skills from the plugin are implicitly disabled. Skills can be added later with `skill add`.
 
+When the selected client uses native install mode, this command validates the
+runtime, source, scope, and live inventory before editing `workspace.yaml`.
+Supported native resources include Pi npm/Git/local packages and OMP
+marketplace plugins. Use `plugin@owner/marketplace-repository` for OMP so
+AllAgents can register and verify the marketplace before install.
+
 ### skill list
 
 List all skills from installed plugins with their enabled/disabled status.

docs/src/content/docs/docs/reference/clients.mdx

@@ -3,11 +3,13 @@ title: Supported Clients
 description: AI coding assistant clients supported by AllAgents.
 ---
 
-AllAgents supports 23 AI coding assistants, organized into universal clients (sharing `.agents/skills/`) and provider-specific clients.
+AllAgents supports 25 AI coding assistants, organized into universal clients (sharing `.agents/skills/`) and provider-specific clients.
 
 ## Universal Clients
 
-These clients share the canonical `.agents/skills/` directory:
+These clients primarily share the canonical `.agents/skills/` directory. The
+Hooks column records artifacts AllAgents materializes; it is not a complete
+inventory of each runtime's native extension APIs.
 
 | Client | Skills | Agent File | Hooks | Commands | GitHub Overrides |
 |--------|--------|------------|-------|----------|------------------|
@@ -22,11 +24,14 @@ These clients share the canonical `.agents/skills/` directory:
 
 ## Provider-Specific Clients
 
-These clients use their own skills directory:
+These clients use their own skills directory. As above, Hooks lists
+AllAgents-managed destinations rather than every native extension mechanism:
 
 | Client | Skills | Agent File | Hooks | Commands |
 |--------|--------|------------|-------|----------|
 | Claude | `.claude/skills/` | `CLAUDE.md` | `.claude/hooks/` | `.claude/commands/` |
+| Pi | `.pi/skills/` | `AGENTS.md` | No—use Pi extensions | No |
+| OMP | `.omp/skills/` | `AGENTS.md` | `.omp/hooks/` | No |
 | Cursor | `.cursor/skills/` | `AGENTS.md` | No | No |
 | Factory | `.factory/skills/` | `AGENTS.md` | `.factory/hooks/` | No |
 | OpenClaw | `skills/` | `AGENTS.md` | No | No |
@@ -46,6 +51,42 @@ These clients use their own skills directory:
 Skills are the cross-client way to share reusable prompts. GitHub overrides (`.github/prompts/`, `.github/agents/`, `.github/hooks/`, `copilot-instructions.md`) are copied to the workspace's `.github/` folder for Copilot/VSCode; package-only `.github/plugin/` metadata is omitted. Root `agents/` and `hooks/` also map to `.github/agents/` and `.github/hooks/` for Copilot. At project scope, plugin hook declarations from `hooks.json` or `hooks/hooks.json` are combined in `.github/hooks/allagents.json`. This translation does not require marketplace registration or `plugin.json`; a missing or disabled declaration adds no managed entries. AllAgents warns and omits a declaration that cannot be read or parsed, lacks the version-1 `hooks` object envelope, or—unless disabled—has a non-array event value. Skipping a declaration does not itself suppress other eligible plugin artifacts or valid declarations from other plugins. At user scope, root `hooks/` maps to `~/.copilot/hooks/`, while repository `.github/hooks/` remains project-scoped.
 :::
 
+### Pi
+
+File sync writes project skills to `.pi/skills/` and user skills to
+`~/.pi/agent/skills/`. Set `PI_CODING_AGENT_DIR` to relocate Pi's user agent
+root.
+
+Native install mode delegates plugin lifecycle to Pi's package manager. Pi
+0.85.1 through 0.85.x is supported. Package sources may be npm specs such as
+`npm:pi-extension`, Git repositories, or local paths. Project-native operations
+fail before mutation unless Pi's trusted settings outside the project boundary
+authorize that project. AllAgents inspects `pi-mcp-adapter` state but does not
+install or configure the adapter.
+
+Pi provides lifecycle interception through extensions discovered from
+`.pi/extensions/` and `~/.pi/agent/extensions/`, not through the portable
+plugin `hooks/` artifact. AllAgents therefore does not map `hooks/` into Pi;
+native Pi packages can supply extensions through Pi's package lifecycle.
+
+### OMP
+
+File sync writes project skills to `.omp/skills/`, user skills to
+`~/.omp/agent/skills/`, and OMP JS/TS hook factories to the corresponding
+`hooks/pre/` or `hooks/post/` discovery path. A factory placed directly in
+`hooks/` is not discovered.
+
+Native install mode requires OMP 18.1.17 or newer and a marketplace-backed
+plugin spec such as `compound-engineering@EveryInc/compound-engineering-plugin`.
+AllAgents registers the required marketplace and delegates the complete plugin
+lifecycle—including OMP-compatible hooks—to OMP. OMP accepts Claude-compatible
+marketplace catalogs, but Claude Code's command-based `hooks/hooks.json` format
+is not interchangeable with OMP's JS/TS hook factories.
+
+Ordinary OMP operations always address the unnamed profile: AllAgents removes
+inherited `OMP_PROFILE`, `PI_PROFILE`, and `PI_CONFIG_FILES` selectors while
+preserving the active HOME and XDG roots.
+
 ### VSCode
 
 VSCode syncs the same skills, agent file, and GitHub overrides as Copilot. Additionally, adding `vscode` to `clients` triggers automatic `.code-workspace` file generation and MCP config syncing during `allagents update`. See the [Workspaces guide](/docs/guides/workspaces/#vscode-workspace-generation) for details.

docs/src/content/docs/docs/reference/configuration.mdx

@@ -53,6 +53,26 @@ clients:
   - cursor
 ```
 
+### Client Install Modes
+
+A bare client name uses file sync. Native mode delegates compatible plugin
+resources to the client's own package or plugin manager:
+
+```yaml
+clients:
+  - pi:native
+  - name: omp
+    install: native
+```
+
+The colon shorthand and object form are equivalent. A plugin object may set its
+own `install: file` or `install: native` override.
+
+Pi native mode supports npm, Git, and local package sources at project or user
+scope. Project installs require trust recorded outside the project-controlled
+Pi agent root. OMP native mode accepts marketplace-backed plugin specs at
+project or user scope and requires OMP 18.1.17 or newer.
+
 ### Setup Commands
 
 The optional top-level `setup` field is an ordered list. A string runs on every

src/cli/agent-help.ts

@@ -17,6 +17,7 @@ import {
   pluginInstallMeta,
   pluginListMeta,
   pluginUninstallMeta,
+  pluginUpdateMeta,
   pluginValidateMeta,
 } from './metadata/plugin.js';
 import { updateMeta } from './metadata/self.js';
@@ -34,6 +35,7 @@ const allCommands: AgentCommandMeta[] = [
   statusMeta,
   pluginInstallMeta,
   pluginUninstallMeta,
+  pluginUpdateMeta,
   marketplaceListMeta,
   marketplaceAddMeta,
   marketplaceRemoveMeta,