@piagent/platform 1.2.15 → 1.2.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/README.md +3 -3
  3. package/docs/README.md +1 -1
  4. package/docs/command-reference-vietnamese.md +2 -2
  5. package/docs/distribution-standard.md +7 -7
  6. package/docs/model-options.md +1 -1
  7. package/docs/operator-manual-vietnamese.md +7 -7
  8. package/docs/release-install-policy.md +6 -6
  9. package/docs/security-threat-model.md +1 -1
  10. package/docs/team-onboarding.md +2 -2
  11. package/docs/vercel-docs-site.md +7 -5
  12. package/docs-site/architecture.html +12 -6
  13. package/docs-site/assets/docs.css +52 -1
  14. package/docs-site/assets/docs.js +4 -2
  15. package/docs-site/benchmark.html +12 -6
  16. package/docs-site/commands.html +12 -6
  17. package/docs-site/content/en/architecture.html +33 -0
  18. package/docs-site/content/en/benchmark.html +164 -0
  19. package/docs-site/content/en/commands.html +39 -0
  20. package/docs-site/content/en/context-engine.html +30 -0
  21. package/docs-site/content/en/index.html +85 -0
  22. package/docs-site/content/en/mcp-approval.html +74 -0
  23. package/docs-site/content/en/mcp-auth.html +57 -0
  24. package/docs-site/content/en/mcp-servers.html +91 -0
  25. package/docs-site/content/en/mcp.html +90 -0
  26. package/docs-site/content/en/permissions.html +19 -0
  27. package/docs-site/content/en/profiles.html +27 -0
  28. package/docs-site/content/en/quickstart.html +126 -0
  29. package/docs-site/content/en/runtime.html +27 -0
  30. package/docs-site/content/en/scope.html +45 -0
  31. package/docs-site/content/en/security.html +33 -0
  32. package/docs-site/content/en/team.html +14 -0
  33. package/docs-site/content/en/workflows.html +21 -0
  34. package/docs-site/content/quickstart.html +1 -1
  35. package/docs-site/context-engine.html +12 -6
  36. package/docs-site/en/architecture.html +166 -0
  37. package/docs-site/en/benchmark.html +297 -0
  38. package/docs-site/en/commands.html +172 -0
  39. package/docs-site/en/context-engine.html +163 -0
  40. package/docs-site/en/index.html +203 -0
  41. package/docs-site/en/mcp-approval.html +207 -0
  42. package/docs-site/en/mcp-auth.html +190 -0
  43. package/docs-site/en/mcp-servers.html +224 -0
  44. package/docs-site/en/mcp.html +223 -0
  45. package/docs-site/en/permissions.html +152 -0
  46. package/docs-site/en/profiles.html +160 -0
  47. package/docs-site/en/quickstart.html +259 -0
  48. package/docs-site/en/runtime.html +160 -0
  49. package/docs-site/en/scope.html +178 -0
  50. package/docs-site/en/security.html +166 -0
  51. package/docs-site/en/team.html +143 -0
  52. package/docs-site/en/workflows.html +154 -0
  53. package/docs-site/index.html +12 -6
  54. package/docs-site/mcp-approval.html +12 -6
  55. package/docs-site/mcp-auth.html +12 -6
  56. package/docs-site/mcp-servers.html +12 -6
  57. package/docs-site/mcp.html +12 -6
  58. package/docs-site/permissions.html +12 -6
  59. package/docs-site/profiles.html +12 -6
  60. package/docs-site/quickstart.html +13 -7
  61. package/docs-site/runtime.html +12 -6
  62. package/docs-site/scope.html +12 -6
  63. package/docs-site/security.html +12 -6
  64. package/docs-site/team.html +12 -6
  65. package/docs-site/workflows.html +12 -6
  66. package/package.json +1 -1
  67. package/packages/piagent-core/package.json +1 -1
  68. package/scripts/build-docs-site.mjs +224 -50
  69. package/scripts/configure-model-scope.sh +4 -4
  70. package/scripts/install-global.sh +1 -1
  71. package/scripts/setup.sh +2 -2
  72. package/scripts/verify-local.sh +7 -1
  73. package/scripts/verify-release-identity.mjs +15 -6
  74. package/templates/global/settings.json +2 -2
  75. package/templates/project/.pi/settings.json +1 -1
package/docs-site/en/profiles.html ADDED
@@ -0,0 +1,160 @@
1
+ <!doctype html>
2
+ <html lang="en" data-copy-success="Copied" data-copy-fallback="Select command">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
6
+ <title>Choose the right operating profile · Pi Agent Platform Docs</title>
7
+ <meta name="description" content="A project profile defines protected paths, verification commands, and the capabilities granted to a repository." />
8
+ <meta name="theme-color" content="#050505" />
9
+ <link rel="canonical" href="https://piagent.io.vn/en/profiles" />
10
+ <link rel="alternate" hreflang="vi" href="https://piagent.io.vn/profiles" />
11
+ <link rel="alternate" hreflang="en" href="https://piagent.io.vn/en/profiles" />
12
+ <link rel="alternate" hreflang="x-default" href="https://piagent.io.vn/profiles" />
13
+ <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
14
+ <meta property="og:title" content="Choose the right operating profile · Pi Agent Platform Docs" />
15
+ <meta property="og:description" content="A project profile defines protected paths, verification commands, and the capabilities granted to a repository." />
16
+ <meta property="og:url" content="https://piagent.io.vn/en/profiles" />
17
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
18
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
19
+ <link
20
+ href="https://fonts.googleapis.com/css2?family=Be+Vietnam+Pro:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;600&display=swap"
21
+ rel="stylesheet"
22
+ />
23
+ <link rel="stylesheet" href="/assets/docs.css" />
24
+ <script src="/assets/docs.js" defer></script>
25
+ </head>
26
+ <body>
27
+ <header class="topbar">
28
+ <a class="brand" href="/en/" aria-label="Pi Agent Platform">
29
+ <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" /></span>
30
+ <span>Pi Agent Platform</span>
31
+ </a>
32
+ <div class="top-actions">
33
+ <span class="pill"><span class="pill-dot"></span>v1.2.17 docs · EN</span>
34
+ <nav class="language-switch" aria-label="Language">
35
+ <a class="language-option" href="/profiles" hreflang="vi" lang="vi">VI</a>
36
+ <a class="language-option current" href="/en/profiles" hreflang="en" lang="en" aria-current="true">EN</a>
37
+ </nav>
38
+ <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Open GitHub repository">
39
+ <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
40
+ <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
41
+ </svg>
42
+ GitHub
43
+ </a>
44
+ <button class="button mobile-menu" type="button" data-menu>Menu</button>
45
+ <a class="button top-command-link" href="/en/commands">Commands</a>
46
+ </div>
47
+ </header>
48
+
49
+ <div class="layout with-toc">
50
+ <aside class="sidebar" data-sidebar>
51
+ <div class="sidebar-search" aria-label="Search documentation">
52
+ <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
53
+ <path d="M10.8 18.1a7.3 7.3 0 1 1 0-14.6 7.3 7.3 0 0 1 0 14.6Zm5.3-1.7 4.4 4.4" stroke="currentColor" stroke-width="2" stroke-linecap="round" />
54
+ </svg>
55
+ <input type="search" placeholder="Search pages" data-filter />
56
+ </div>
57
+
58
+ <nav aria-label="Documentation">
59
+ <div class="nav-group">
60
+ <p class="nav-title">Get started</p>
61
+ <a class="nav-link" href="/en/">Overview</a>
62
+ <a class="nav-link" href="/en/quickstart">Quickstart</a>
63
+ <a class="nav-link" href="/en/scope">Platform scope</a>
64
+ </div>
65
+ <div class="nav-group">
66
+ <p class="nav-title">Build</p>
67
+ <a class="nav-link current" href="/en/profiles" aria-current="page">Project profiles</a>
68
+ <a class="nav-link" href="/en/permissions">Permission modes</a>
69
+ <a class="nav-link" href="/en/commands">Command catalog</a>
70
+ <a class="nav-link" href="/en/workflows">Workflows</a>
71
+ </div>
72
+ <div class="nav-group">
73
+ <p class="nav-title">MCP</p>
74
+ <a class="nav-link" href="/en/mcp">MCP overview</a>
75
+ <a class="nav-link" href="/en/mcp-servers">Server management</a>
76
+ <a class="nav-link" href="/en/mcp-auth">Authentication</a>
77
+ <a class="nav-link" href="/en/mcp-approval">Approval gate</a>
78
+ </div>
79
+ <div class="nav-group">
80
+ <p class="nav-title">Operate</p>
81
+ <a class="nav-link" href="/en/security">Security model</a>
82
+ <a class="nav-link" href="/en/architecture">Architecture</a>
83
+ <a class="nav-link" href="/en/context-engine">Context Engine</a>
84
+ <a class="nav-link" href="/en/benchmark">Benchmark</a>
85
+ <a class="nav-link" href="/en/runtime">Runtime tools</a>
86
+ <a class="nav-link" href="/en/team">Team usage</a>
87
+ </div>
88
+ </nav>
89
+ </aside>
90
+
91
+ <main>
92
+ <div class="content-shell" data-article>
93
+ <nav class="breadcrumb" aria-label="Breadcrumb">
94
+ <a href="/en/">Docs</a>
95
+ <span aria-hidden="true">/</span>
96
+ <span>Build</span>
97
+ <span aria-hidden="true">/</span>
98
+ <span>Project profiles</span>
99
+ </nav>
100
+ <div class="page-head">
101
+ <h1>Choose the right operating profile</h1>
102
+ <p>A project profile defines protected paths, verification commands, and the capabilities granted to a repository.</p>
103
+ </div>
104
+ <section class="section">
105
+ <div class="command-grid">
106
+ <article class="command-card"><header><span>Show concise status</span><button class="clip-btn" data-clip="/profile">Copy</button></header><pre><code>/profile</code></pre></article>
107
+ <article class="command-card"><header><span>List options</span><button class="clip-btn" data-clip="/profile list">Copy</button></header><pre><code>/profile list</code></pre></article>
108
+ <article class="command-card"><header><span>Apply detected profile</span><button class="clip-btn" data-clip="/profile auto">Copy</button></header><pre><code>/profile auto</code></pre></article>
109
+ <article class="command-card"><header><span>Interactive setup</span><button class="clip-btn" data-clip="/profile setup&#10;/profile tech setup fullstack">Copy</button></header><pre><code>/profile setup
110
+ /profile tech setup fullstack</code></pre></article>
111
+ <article class="command-card"><header><span>Deterministic tech selection</span><button class="clip-btn" data-clip="/profile tech apply fullstack frontend=nextjs backend=nestjs database=prisma">Copy</button></header><pre><code>/profile tech apply fullstack frontend=nextjs backend=nestjs database=prisma</code></pre></article>
112
+ <article class="command-card"><header><span>Frontend</span><button class="clip-btn" data-clip="/profile web-frontend">Copy</button></header><pre><code>/profile web-frontend
113
+ /profile fe</code></pre></article>
114
+ <article class="command-card"><header><span>Backend/API</span><button class="clip-btn" data-clip="/profile backend-api">Copy</button></header><pre><code>/profile backend-api</code></pre></article>
115
+ <article class="command-card"><header><span>Read-only backend, writable frontend</span><button class="clip-btn" data-clip="/profile be-readonly-fe">Copy</button></header><pre><code>/profile be-readonly-fe
116
+ /profile be-fe</code></pre></article>
117
+ <article class="command-card"><header><span>Full stack</span><button class="clip-btn" data-clip="/profile fullstack">Copy</button></header><pre><code>/profile fullstack
118
+ /profile full</code></pre></article>
119
+ <article class="command-card"><header><span>Docs only</span><button class="clip-btn" data-clip="/profile docs">Copy</button></header><pre><code>/profile docs</code></pre></article>
120
+ </div>
121
+
122
+ <div class="tag-list">
123
+ <span class="tag">generic</span><span class="tag">node-typescript</span><span class="tag">python</span><span class="tag">web-frontend</span><span class="tag">backend-api</span><span class="tag">fullstack</span><span class="tag">be-readonly-fe</span><span class="tag">data</span><span class="tag">devops</span><span class="tag">mobile</span><span class="tag">docs</span>
124
+ </div>
125
+
126
+ <div class="callout">
127
+ <strong>Technology stack by role</strong>
128
+ <p>Frontend profiles select frontend technology and an optional database; backend profiles select backend technology and an optional database; full-stack profiles select frontend, backend, and database. The platform then writes <span class="inline-code">.pi/tech-stack.json</span> and a compact Context7 snapshot under <span class="inline-code">.pi/tech-context/*</span>.</p>
129
+ </div>
130
+ </section>
131
+ <nav class="pager" aria-label="Adjacent pages">
132
+ <a class="pager-prev" href="/en/scope">
133
+ <span class="pager-label">Previous</span>
134
+ <span class="pager-title">Platform scope</span>
135
+ </a>
136
+ <a class="pager-next" href="/en/permissions">
137
+ <span class="pager-label">Next</span>
138
+ <span class="pager-title">Permission modes</span>
139
+ </a>
140
+ </nav>
141
+
142
+ <footer class="footer">
143
+ <p>Pi Agent Platform docs · static HTML · governed agent workflow</p>
144
+ <div class="footer-links" aria-label="External links">
145
+ <a href="https://piagent.io.vn" target="_blank" rel="noopener noreferrer">piagent.io.vn</a>
146
+ <a href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer">GitHub repository</a>
147
+ <a href="/profiles" hreflang="vi">Tiếng Việt</a>
148
+ <a href="https://www.facebook.com/vinhtam0544/" target="_blank" rel="noopener noreferrer">Facebook profile</a>
149
+ </div>
150
+ </footer>
151
+ </div>
152
+ </main>
153
+
154
+ <aside class="toc" aria-label="Page contents">
155
+ <p class="toc-title">On this page</p>
156
+ <nav data-toc></nav>
157
+ </aside>
158
+ </div>
159
+ </body>
160
+ </html>
package/docs-site/en/quickstart.html ADDED
@@ -0,0 +1,259 @@
1
+ <!doctype html>
2
+ <html lang="en" data-copy-success="Copied" data-copy-fallback="Select command">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
6
+ <title>Step by step for new team members · Pi Agent Platform Docs</title>
7
+ <meta name="description" content="Install with two commands, open a repository, select its profile and permission mode, run a task, and verify real evidence before handoff." />
8
+ <meta name="theme-color" content="#050505" />
9
+ <link rel="canonical" href="https://piagent.io.vn/en/quickstart" />
10
+ <link rel="alternate" hreflang="vi" href="https://piagent.io.vn/quickstart" />
11
+ <link rel="alternate" hreflang="en" href="https://piagent.io.vn/en/quickstart" />
12
+ <link rel="alternate" hreflang="x-default" href="https://piagent.io.vn/quickstart" />
13
+ <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
14
+ <meta property="og:title" content="Step by step for new team members · Pi Agent Platform Docs" />
15
+ <meta property="og:description" content="Install with two commands, open a repository, select its profile and permission mode, run a task, and verify real evidence before handoff." />
16
+ <meta property="og:url" content="https://piagent.io.vn/en/quickstart" />
17
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
18
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
19
+ <link
20
+ href="https://fonts.googleapis.com/css2?family=Be+Vietnam+Pro:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;600&display=swap"
21
+ rel="stylesheet"
22
+ />
23
+ <link rel="stylesheet" href="/assets/docs.css" />
24
+ <script src="/assets/docs.js" defer></script>
25
+ </head>
26
+ <body>
27
+ <header class="topbar">
28
+ <a class="brand" href="/en/" aria-label="Pi Agent Platform">
29
+ <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" /></span>
30
+ <span>Pi Agent Platform</span>
31
+ </a>
32
+ <div class="top-actions">
33
+ <span class="pill"><span class="pill-dot"></span>v1.2.17 docs · EN</span>
34
+ <nav class="language-switch" aria-label="Language">
35
+ <a class="language-option" href="/quickstart" hreflang="vi" lang="vi">VI</a>
36
+ <a class="language-option current" href="/en/quickstart" hreflang="en" lang="en" aria-current="true">EN</a>
37
+ </nav>
38
+ <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Open GitHub repository">
39
+ <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
40
+ <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
41
+ </svg>
42
+ GitHub
43
+ </a>
44
+ <button class="button mobile-menu" type="button" data-menu>Menu</button>
45
+ <a class="button top-command-link" href="/en/commands">Commands</a>
46
+ </div>
47
+ </header>
48
+
49
+ <div class="layout with-toc">
50
+ <aside class="sidebar" data-sidebar>
51
+ <div class="sidebar-search" aria-label="Search documentation">
52
+ <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
53
+ <path d="M10.8 18.1a7.3 7.3 0 1 1 0-14.6 7.3 7.3 0 0 1 0 14.6Zm5.3-1.7 4.4 4.4" stroke="currentColor" stroke-width="2" stroke-linecap="round" />
54
+ </svg>
55
+ <input type="search" placeholder="Search pages" data-filter />
56
+ </div>
57
+
58
+ <nav aria-label="Documentation">
59
+ <div class="nav-group">
60
+ <p class="nav-title">Get started</p>
61
+ <a class="nav-link" href="/en/">Overview</a>
62
+ <a class="nav-link current" href="/en/quickstart" aria-current="page">Quickstart</a>
63
+ <a class="nav-link" href="/en/scope">Platform scope</a>
64
+ </div>
65
+ <div class="nav-group">
66
+ <p class="nav-title">Build</p>
67
+ <a class="nav-link" href="/en/profiles">Project profiles</a>
68
+ <a class="nav-link" href="/en/permissions">Permission modes</a>
69
+ <a class="nav-link" href="/en/commands">Command catalog</a>
70
+ <a class="nav-link" href="/en/workflows">Workflows</a>
71
+ </div>
72
+ <div class="nav-group">
73
+ <p class="nav-title">MCP</p>
74
+ <a class="nav-link" href="/en/mcp">MCP overview</a>
75
+ <a class="nav-link" href="/en/mcp-servers">Server management</a>
76
+ <a class="nav-link" href="/en/mcp-auth">Authentication</a>
77
+ <a class="nav-link" href="/en/mcp-approval">Approval gate</a>
78
+ </div>
79
+ <div class="nav-group">
80
+ <p class="nav-title">Operate</p>
81
+ <a class="nav-link" href="/en/security">Security model</a>
82
+ <a class="nav-link" href="/en/architecture">Architecture</a>
83
+ <a class="nav-link" href="/en/context-engine">Context Engine</a>
84
+ <a class="nav-link" href="/en/benchmark">Benchmark</a>
85
+ <a class="nav-link" href="/en/runtime">Runtime tools</a>
86
+ <a class="nav-link" href="/en/team">Team usage</a>
87
+ </div>
88
+ </nav>
89
+ </aside>
90
+
91
+ <main>
92
+ <div class="content-shell" data-article>
93
+ <nav class="breadcrumb" aria-label="Breadcrumb">
94
+ <a href="/en/">Docs</a>
95
+ <span aria-hidden="true">/</span>
96
+ <span>Get started</span>
97
+ <span aria-hidden="true">/</span>
98
+ <span>Quickstart</span>
99
+ </nav>
100
+ <div class="page-head">
101
+ <h1>Step by step for new team members</h1>
102
+ <p>Install with two commands, open a repository, select its profile and permission mode, run a task, and verify real evidence before handoff.</p>
103
+ </div>
104
+ <section class="section">
105
+ <div class="steps">
106
+ <article class="step">
107
+ <div>
108
+ <h3 id="install-two-commands">Install with two commands</h3>
109
+ <p>Requires Node.js 22.19.0 or newer. You do not need to install Pi Coding Agent first: <span class="inline-code">piagent-setup</span> installs the exact host version pinned by the current release. Run it inside the project directory. It installs the Pi package, initializes <span class="inline-code">.pi/</span>, installs the MCP baseline and subagents, and runs doctor. Use <span class="inline-code">--no-mcp</span>, <span class="inline-code">--no-subagents</span>, <span class="inline-code">--no-herdr</span>, or <span class="inline-code">--global-only</span> to omit optional parts.</p>
110
+ <div class="table-wrap compact-table">
111
+ <table>
112
+ <thead><tr><th>Runtime</th><th>Rollout status</th></tr></thead>
113
+ <tbody>
114
+ <tr><td>macOS Apple Silicon + Bash</td><td>Verified for this release.</td></tr>
115
+ <tr><td>Linux x64 + Bash</td><td>Verified in CI.</td></tr>
116
+ <tr><td>macOS Intel / Linux ARM64 + Bash</td><td>Supported target; run doctor and smoke tests before broad rollout.</td></tr>
117
+ <tr><td>Native Windows / WSL2</td><td>Not a team rollout target; WSL2 remains experimental.</td></tr>
118
+ </tbody>
119
+ </table>
120
+ </div>
121
+ <div class="command-card">
122
+ <header><span>Two commands</span><button class="clip-btn" data-clip="npm install -g @piagent/platform&#10;piagent-setup">Copy</button></header>
123
+ <pre><code>npm install -g @piagent/platform
124
+ piagent-setup</code></pre>
125
+ </div>
126
+ <p>Because setup runs from the installed package, the source written to <span class="inline-code">.pi/settings.json</span> is <span class="inline-code">npm:@piagent/platform@&lt;version&gt;</span>. It resolves consistently on teammate machines and can be committed.</p>
127
+ <p>If you use <a href="https://herdr.dev/docs/install/">Herdr</a>, install it <strong>first</strong>. <span class="inline-code">piagent-setup</span> installs the Herdr Pi integration when <span class="inline-code">herdr</span> is present on <span class="inline-code">PATH</span>. Otherwise it skips the integration with a warning; after installing Herdr, run <span class="inline-code">piagent-setup --global-only</span>.</p>
128
+ <div class="command-card">
129
+ <header><span>Herdr (optional, install first)</span><button class="clip-btn" data-clip="brew install herdr">Copy</button></header>
130
+ <pre><code>brew install herdr # macOS
131
+ curl -fsSL https://herdr.dev/install.sh | sh # macOS or Linux</code></pre>
132
+ </div>
133
+ <p>The <span class="inline-code">curl</span> form executes a downloaded installer. For an auditable path, use <span class="inline-code">brew</span> or download from <a href="https://github.com/ogulcancelik/herdr/releases">GitHub releases</a>. Herdr stable supports macOS and Linux; Windows remains preview.</p>
134
+ <p>See the <a href="https://github.com/Vt-mmm/piagent/blob/main/docs/release-install-policy.md">release and install policy</a> for pinned rollout, updates, rollback, and the latest channel for personal machines.</p>
135
+ </div>
136
+ </article>
137
+
138
+ <article class="step">
139
+ <div>
140
+ <h3 id="open-project-repository">Open the project repository</h3>
141
+ <p>Start Pi from the repository directory. In a trusted repository, use the trusted-run wrapper only when controlled automation is needed.</p>
142
+ <div class="command-card">
143
+ <header><span>Start</span><button class="clip-btn" data-clip="cd /path/to/project && pi">Copy</button></header>
144
+ <pre><code>cd /path/to/project
145
+ pi</code></pre>
146
+ </div>
147
+ <p>For multiple parallel agents, run <span class="inline-code">herdr</span> instead of <span class="inline-code">pi</span> and assign one role per pane: implementation, read-only review, verification, or notes. Herdr coordinates terminals and sessions; it is not a security boundary. Gates remain in the Pi extension and OAuth still occurs in Pi. See the <a href="https://github.com/Vt-mmm/piagent/blob/main/docs/herdr-workflow.md">Herdr workflow</a>.</p>
148
+ </div>
149
+ </article>
150
+
151
+ <article class="step">
152
+ <div>
153
+ <h3 id="onboard-context">Onboard context</h3>
154
+ <p>Run this once in a new repository to record project context, verification matrices, and protected areas under <span class="inline-code">.pi/</span>. <span class="inline-code">/onboard</span> opens the menu and status; <span class="inline-code">run</span> launches the project-reading workflow.</p>
155
+ <div class="command-card">
156
+ <header><span>Onboard</span><button class="clip-btn" data-clip="/onboard&#10;/onboard run">Copy</button></header>
157
+ <pre><code>/onboard
158
+ /onboard run</code></pre>
159
+ </div>
160
+ </div>
161
+ </article>
162
+
163
+ <article class="step">
164
+ <div>
165
+ <h3 id="select-profile-and-tech">Select profile and technology</h3>
166
+ <p>Use <span class="inline-code">/profile setup</span> for the interactive selector: choose the profile, then the technology by role. Full-stack setup selects frontend, backend, and database.</p>
167
+ <div class="command-card">
168
+ <header><span>Profile and tech setup</span><button class="clip-btn" data-clip="/profile setup&#10;/profile tech setup fullstack">Copy</button></header>
169
+ <pre><code>/profile setup
170
+ /profile tech setup fullstack</code></pre>
171
+ </div>
172
+ </div>
173
+ </article>
174
+
175
+ <article class="step">
176
+ <div>
177
+ <h3 id="select-permission">Select a permission mode</h3>
178
+ <p>Use read-only for scouting, workspace-write for normal coding, and guarded full access for trusted automation.</p>
179
+ <div class="command-card">
180
+ <header><span>Permission</span><button class="clip-btn" data-clip="/permission status&#10;/permission workspace-write">Copy</button></header>
181
+ <pre><code>/permission status
182
+ /permission workspace-write</code></pre>
183
+ </div>
184
+ </div>
185
+ </article>
186
+
187
+ <article class="step">
188
+ <div>
189
+ <h3 id="run-workflow">Run a workflow</h3>
190
+ <p>Use the command that matches the intent so the agent does not spend context rediscovering the process. Start a fresh session for context-heavy work.</p>
191
+ <div class="command-card">
192
+ <header><span>Workflow</span><button class="clip-btn" data-clip="/workflow task Implement the requested bounded change.&#10;/workflow review current diff&#10;/fresh task Implement the requested bounded change.">Copy</button></header>
193
+ <pre><code>/workflow task Implement the requested bounded change.
194
+ /workflow review current diff
195
+ /fresh task Implement the requested bounded change.</code></pre>
196
+ </div>
197
+ </div>
198
+ </article>
199
+
200
+ <article class="step">
201
+ <div>
202
+ <h3 id="verify-before-handoff">Verify before handoff</h3>
203
+ <p>The final gate trusts only commands that actually ran, exited successfully, and matched the verification plan. After pinning or upgrading a version, run doctor in the project:</p>
204
+ <div class="command-card">
205
+ <header><span>Doctor</span><button class="clip-btn" data-clip="piagent-doctor">Copy</button></header>
206
+ <pre><code>piagent-doctor</code></pre>
207
+ </div>
208
+ <p>Platform maintainers also run <span class="inline-code">npm run verify</span> in the source repository. See <a href="https://github.com/Vt-mmm/piagent/blob/main/CONTRIBUTING.md">CONTRIBUTING</a>.</p>
209
+ </div>
210
+ </article>
211
+
212
+ <article class="step">
213
+ <div>
214
+ <h3 id="uninstall">Uninstall when no longer needed</h3>
215
+ <p><span class="inline-code">piagent-uninstall</span> is a dry run by default. Add <span class="inline-code">--apply</span> to make changes because it edits Pi settings that other tools may also use. The default removes only the platform's Pi package; add-ons, the Pi host, and project state are opt-in.</p>
216
+ <div class="command-card">
217
+ <header><span>Uninstall in two steps</span><button class="clip-btn" data-clip="piagent-uninstall&#10;piagent-uninstall --apply">Copy</button></header>
218
+ <pre><code>piagent-uninstall
219
+ piagent-uninstall --apply</code></pre>
220
+ </div>
221
+ <p>Add-ons, the Pi host, project state, and the global npm helper each have separate opt-in flags listed by <span class="inline-code">piagent-uninstall --help</span>. Removal follows packages registered in Pi settings, so registrations created by older releases are still found.</p>
222
+ <div class="callout ok-callout">
223
+ <strong>Never removed</strong>
224
+ <p>Credentials, trust decisions, sessions, todos, and <span class="inline-code">.pi/memory/</span> remain under every flag combination. Generated files that may have been edited, such as <span class="inline-code">AGENTS.md</span>, <span class="inline-code">.pi/settings.json</span>, and <span class="inline-code">project-context.md</span>, are listed for manual review. In <span class="inline-code">.pi/settings.json</span>, only the package entry that points to the platform is removed.</p>
225
+ </div>
226
+ </div>
227
+ </article>
228
+ </div>
229
+ </section>
230
+ <nav class="pager" aria-label="Adjacent pages">
231
+ <a class="pager-prev" href="/en/">
232
+ <span class="pager-label">Previous</span>
233
+ <span class="pager-title">Overview</span>
234
+ </a>
235
+ <a class="pager-next" href="/en/scope">
236
+ <span class="pager-label">Next</span>
237
+ <span class="pager-title">Platform scope</span>
238
+ </a>
239
+ </nav>
240
+
241
+ <footer class="footer">
242
+ <p>Pi Agent Platform docs · static HTML · governed agent workflow</p>
243
+ <div class="footer-links" aria-label="External links">
244
+ <a href="https://piagent.io.vn" target="_blank" rel="noopener noreferrer">piagent.io.vn</a>
245
+ <a href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer">GitHub repository</a>
246
+ <a href="/quickstart" hreflang="vi">Tiếng Việt</a>
247
+ <a href="https://www.facebook.com/vinhtam0544/" target="_blank" rel="noopener noreferrer">Facebook profile</a>
248
+ </div>
249
+ </footer>
250
+ </div>
251
+ </main>
252
+
253
+ <aside class="toc" aria-label="Page contents">
254
+ <p class="toc-title">On this page</p>
255
+ <nav data-toc></nav>
256
+ </aside>
257
+ </div>
258
+ </body>
259
+ </html>
package/docs-site/en/runtime.html ADDED
@@ -0,0 +1,160 @@
1
+ <!doctype html>
2
+ <html lang="en" data-copy-success="Copied" data-copy-fallback="Select command">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
6
+ <title>Terminal commands for operators · Pi Agent Platform Docs</title>
7
+ <meta name="description" content="Use these commands outside Pi for setup, updates, doctor checks, benchmarks, capabilities, and MCP management." />
8
+ <meta name="theme-color" content="#050505" />
9
+ <link rel="canonical" href="https://piagent.io.vn/en/runtime" />
10
+ <link rel="alternate" hreflang="vi" href="https://piagent.io.vn/runtime" />
11
+ <link rel="alternate" hreflang="en" href="https://piagent.io.vn/en/runtime" />
12
+ <link rel="alternate" hreflang="x-default" href="https://piagent.io.vn/runtime" />
13
+ <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
14
+ <meta property="og:title" content="Terminal commands for operators · Pi Agent Platform Docs" />
15
+ <meta property="og:description" content="Use these commands outside Pi for setup, updates, doctor checks, benchmarks, capabilities, and MCP management." />
16
+ <meta property="og:url" content="https://piagent.io.vn/en/runtime" />
17
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
18
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
19
+ <link
20
+ href="https://fonts.googleapis.com/css2?family=Be+Vietnam+Pro:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500;600&display=swap"
21
+ rel="stylesheet"
22
+ />
23
+ <link rel="stylesheet" href="/assets/docs.css" />
24
+ <script src="/assets/docs.js" defer></script>
25
+ </head>
26
+ <body>
27
+ <header class="topbar">
28
+ <a class="brand" href="/en/" aria-label="Pi Agent Platform">
29
+ <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" /></span>
30
+ <span>Pi Agent Platform</span>
31
+ </a>
32
+ <div class="top-actions">
33
+ <span class="pill"><span class="pill-dot"></span>v1.2.17 docs · EN</span>
34
+ <nav class="language-switch" aria-label="Language">
35
+ <a class="language-option" href="/runtime" hreflang="vi" lang="vi">VI</a>
36
+ <a class="language-option current" href="/en/runtime" hreflang="en" lang="en" aria-current="true">EN</a>
37
+ </nav>
38
+ <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Open GitHub repository">
39
+ <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
40
+ <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
41
+ </svg>
42
+ GitHub
43
+ </a>
44
+ <button class="button mobile-menu" type="button" data-menu>Menu</button>
45
+ <a class="button top-command-link" href="/en/commands">Commands</a>
46
+ </div>
47
+ </header>
48
+
49
+ <div class="layout with-toc">
50
+ <aside class="sidebar" data-sidebar>
51
+ <div class="sidebar-search" aria-label="Search documentation">
52
+ <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
53
+ <path d="M10.8 18.1a7.3 7.3 0 1 1 0-14.6 7.3 7.3 0 0 1 0 14.6Zm5.3-1.7 4.4 4.4" stroke="currentColor" stroke-width="2" stroke-linecap="round" />
54
+ </svg>
55
+ <input type="search" placeholder="Search pages" data-filter />
56
+ </div>
57
+
58
+ <nav aria-label="Documentation">
59
+ <div class="nav-group">
60
+ <p class="nav-title">Get started</p>
61
+ <a class="nav-link" href="/en/">Overview</a>
62
+ <a class="nav-link" href="/en/quickstart">Quickstart</a>
63
+ <a class="nav-link" href="/en/scope">Platform scope</a>
64
+ </div>
65
+ <div class="nav-group">
66
+ <p class="nav-title">Build</p>
67
+ <a class="nav-link" href="/en/profiles">Project profiles</a>
68
+ <a class="nav-link" href="/en/permissions">Permission modes</a>
69
+ <a class="nav-link" href="/en/commands">Command catalog</a>
70
+ <a class="nav-link" href="/en/workflows">Workflows</a>
71
+ </div>
72
+ <div class="nav-group">
73
+ <p class="nav-title">MCP</p>
74
+ <a class="nav-link" href="/en/mcp">MCP overview</a>
75
+ <a class="nav-link" href="/en/mcp-servers">Server management</a>
76
+ <a class="nav-link" href="/en/mcp-auth">Authentication</a>
77
+ <a class="nav-link" href="/en/mcp-approval">Approval gate</a>
78
+ </div>
79
+ <div class="nav-group">
80
+ <p class="nav-title">Operate</p>
81
+ <a class="nav-link" href="/en/security">Security model</a>
82
+ <a class="nav-link" href="/en/architecture">Architecture</a>
83
+ <a class="nav-link" href="/en/context-engine">Context Engine</a>
84
+ <a class="nav-link" href="/en/benchmark">Benchmark</a>
85
+ <a class="nav-link current" href="/en/runtime" aria-current="page">Runtime tools</a>
86
+ <a class="nav-link" href="/en/team">Team usage</a>
87
+ </div>
88
+ </nav>
89
+ </aside>
90
+
91
+ <main>
92
+ <div class="content-shell" data-article>
93
+ <nav class="breadcrumb" aria-label="Breadcrumb">
94
+ <a href="/en/">Docs</a>
95
+ <span aria-hidden="true">/</span>
96
+ <span>Operate</span>
97
+ <span aria-hidden="true">/</span>
98
+ <span>Runtime tools</span>
99
+ </nav>
100
+ <div class="page-head">
101
+ <h1>Terminal commands for operators</h1>
102
+ <p>Use these commands outside Pi for setup, updates, doctor checks, benchmarks, capabilities, and MCP management.</p>
103
+ </div>
104
+ <section class="section">
105
+ <div class="command-grid">
106
+ <article class="command-card"><header><span>Global setup</span><button class="clip-btn" data-clip="piagent-setup --mcp-preset core --subagents-preset safe">Copy</button></header><pre><code>piagent-setup --mcp-preset core --subagents-preset safe</code></pre></article>
107
+ <article class="command-card"><header><span>Full update</span><button class="clip-btn" data-clip="npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.82.0&#10;npm install -g --ignore-scripts @piagent/platform@X.Y.Z&#10;piagent-install --stable --dry-run&#10;piagent-install --stable">Copy</button></header><pre><code>npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.82.0
108
+ npm install -g --ignore-scripts @piagent/platform@X.Y.Z
109
+ piagent-install --stable --dry-run
110
+ piagent-install --stable</code></pre></article>
111
+ <article class="command-card"><header><span>Pi package only</span><button class="clip-btn" data-clip="piagent-install --version vX.Y.Z --resolve-tag --dry-run&#10;piagent-install --version vX.Y.Z --resolve-tag">Copy</button></header><pre><code>piagent-install --version vX.Y.Z --resolve-tag --dry-run
112
+ piagent-install --version vX.Y.Z --resolve-tag</code></pre></article>
113
+ <article class="command-card"><header><span>Initialize a project</span><button class="clip-btn" data-clip="piagent-init /path/to/project">Copy</button></header><pre><code>piagent-init /path/to/project</code></pre></article>
114
+ <article class="command-card"><header><span>Doctor</span><button class="clip-btn" data-clip="piagent-doctor /path/to/project">Copy</button></header><pre><code>piagent-doctor /path/to/project</code></pre></article>
115
+ <article class="command-card"><header><span>Smoke benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --dry-run&#10;piagent-benchmark">Copy</button></header><pre><code>piagent-benchmark --dry-run
116
+ piagent-benchmark</code></pre></article>
117
+ <article class="command-card"><header><span>Production benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --production --dry-run&#10;piagent-benchmark --production --surfaces piagent,codex-cli --model openai-codex/gpt-5.6-sol --thinking xhigh">Copy</button></header><pre><code>piagent-benchmark --production --dry-run
118
+ piagent-benchmark --production --surfaces piagent,codex-cli \
119
+ --model openai-codex/gpt-5.6-sol --thinking xhigh</code></pre></article>
120
+ <article class="command-card"><header><span>Compare codex-cli</span><button class="clip-btn" data-clip="piagent-benchmark --surfaces piagent,codex-cli --model openai-codex/gpt-5.6-sol --thinking xhigh">Copy</button></header><pre><code>piagent-benchmark --surfaces piagent,codex-cli \
121
+ --model openai-codex/gpt-5.6-sol --thinking xhigh</code></pre></article>
122
+ <article class="command-card"><header><span>Trusted run</span><button class="clip-btn" data-clip="piagent-auto --full-access -p &quot;Run the trusted local benchmark suite.&quot;">Copy</button></header><pre><code>piagent-auto --read-only -p "Scout payment mapping. Do not edit source."
123
+ piagent-auto --full-access -p "Run the trusted local benchmark suite."</code></pre></article>
124
+ <article class="command-card"><header><span>Capabilities</span><button class="clip-btn" data-clip="piagent-capabilities catalog --check&#10;piagent-capabilities doctor --profile .pi/piagent-profile.json">Copy</button></header><pre><code>piagent-capabilities catalog --check
125
+ piagent-capabilities doctor --profile .pi/piagent-profile.json</code></pre></article>
126
+ <article class="command-card"><header><span>Verification</span><button class="clip-btn" data-clip="npm run verify&#10;npm test&#10;npm run typecheck">Copy</button></header><pre><code>npm run verify
127
+ npm test
128
+ npm run typecheck</code></pre></article>
129
+ </div>
130
+ </section>
131
+ <nav class="pager" aria-label="Adjacent pages">
132
+ <a class="pager-prev" href="/en/benchmark">
133
+ <span class="pager-label">Previous</span>
134
+ <span class="pager-title">Benchmark</span>
135
+ </a>
136
+ <a class="pager-next" href="/en/team">
137
+ <span class="pager-label">Next</span>
138
+ <span class="pager-title">Team usage</span>
139
+ </a>
140
+ </nav>
141
+
142
+ <footer class="footer">
143
+ <p>Pi Agent Platform docs · static HTML · governed agent workflow</p>
144
+ <div class="footer-links" aria-label="External links">
145
+ <a href="https://piagent.io.vn" target="_blank" rel="noopener noreferrer">piagent.io.vn</a>
146
+ <a href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer">GitHub repository</a>
147
+ <a href="/runtime" hreflang="vi">Tiếng Việt</a>
148
+ <a href="https://www.facebook.com/vinhtam0544/" target="_blank" rel="noopener noreferrer">Facebook profile</a>
149
+ </div>
150
+ </footer>
151
+ </div>
152
+ </main>
153
+
154
+ <aside class="toc" aria-label="Page contents">
155
+ <p class="toc-title">On this page</p>
156
+ <nav data-toc></nav>
157
+ </aside>
158
+ </div>
159
+ </body>
160
+ </html>