Team operating docs
A reusable Pi runtime for every project.
These docs bring installation, profiles, permissions, MCP, security, and workflows into one place. A new team member can find the right command, choose a safe mode, and understand the operating boundary without rebuilding the process in a prompt.
Install with two commands
Requires Node.js >=22.19.0. Run these commands from the project you want to configure.
npm install -g @piagent/platform
piagent-setuppiagent-setup installs the pinned Pi Coding Agent host, installs the Pi package, initializes the current directory, and runs doctor. It also installs the MCP baseline and subagents; skip them with --no-mcp, --no-subagents, or --global-only. See the Quickstart for the complete flow.
Where to start
Quickstart
Install, open a repository, onboard context, choose a profile and permission mode, run the first task, and verify before handoff.
Get startedPlatform scope
Why this repository exists alongside general coding agents, and which operating concerns it owns.
BuildProject profiles
Choose the operating profile for a repository: protected paths, verification commands, and granted capabilities.
MCPMCP
Four configuration layers, pinned presets, server management, authentication readiness, and repository approval gates.
OperateSecurity model
A policy enforcement layer, not an OS sandbox, with explicit claims about what is and is not controlled.
OperateProduction benchmark
Quality, safety, workflow, and token evidence from 108 sessions compared with the codex-cli surface.
Command catalog
Slash commands and terminal commands grouped by the job they perform.
Three documentation groups
Get started
For first-time users: installation, quickstart, and where the platform fits alongside other agent CLIs.
Build
Daily operation: profiles, permissions, commands, workflows, and a dedicated MCP section for its broader command surface.
Operate
For operators and reviewers: security boundaries, repository architecture, terminal tools, and the team operating standard.