@piagent/platform 1.41.0 → 1.42.0

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 (107) hide show
  1. package/CHANGELOG.md +1006 -2038
  2. package/CONTRIBUTING.md +2 -0
  3. package/README.md +128 -325
  4. package/README.vi.md +149 -143
  5. package/docs/command-reference-vietnamese.md +2 -2
  6. package/docs/distribution-standard.md +6 -6
  7. package/docs/languages.json +2 -2
  8. package/docs/operator-manual-vietnamese.md +7 -7
  9. package/docs/publishing-for-teams.md +1 -0
  10. package/docs/release-install-policy.md +3 -3
  11. package/docs/team-onboarding.md +2 -2
  12. package/docs-site/architecture.html +71 -63
  13. package/docs-site/assets/docs.css +2736 -1030
  14. package/docs-site/assets/docs.js +451 -43
  15. package/docs-site/assets/og.png +0 -0
  16. package/docs-site/assets/piagent-logo.svg +9 -31
  17. package/docs-site/assets/search-en.json +1 -0
  18. package/docs-site/assets/search-vi.json +1 -0
  19. package/docs-site/benchmark.html +71 -63
  20. package/docs-site/commands.html +72 -64
  21. package/docs-site/content/en/index.html +220 -131
  22. package/docs-site/content/en/quickstart.html +74 -90
  23. package/docs-site/content/en/update.html +80 -0
  24. package/docs-site/content/en/whats-new.html +1 -684
  25. package/docs-site/content/index.html +220 -131
  26. package/docs-site/content/quickstart.html +73 -108
  27. package/docs-site/content/update.html +80 -0
  28. package/docs-site/content/whats-new.html +1 -684
  29. package/docs-site/context-engine.html +73 -65
  30. package/docs-site/ecosystem.html +73 -65
  31. package/docs-site/en/architecture.html +67 -59
  32. package/docs-site/en/benchmark.html +67 -59
  33. package/docs-site/en/commands.html +68 -60
  34. package/docs-site/en/context-engine.html +68 -60
  35. package/docs-site/en/ecosystem.html +68 -60
  36. package/docs-site/en/index.html +281 -220
  37. package/docs-site/en/mcp-approval.html +67 -59
  38. package/docs-site/en/mcp-auth.html +67 -59
  39. package/docs-site/en/mcp-servers.html +68 -60
  40. package/docs-site/en/mcp.html +64 -56
  41. package/docs-site/en/permissions.html +68 -60
  42. package/docs-site/en/profiles.html +68 -60
  43. package/docs-site/en/quickstart.html +142 -150
  44. package/docs-site/en/runtime.html +67 -59
  45. package/docs-site/en/scope.html +68 -60
  46. package/docs-site/en/security.html +64 -56
  47. package/docs-site/en/team.html +67 -59
  48. package/docs-site/en/update.html +228 -0
  49. package/docs-site/en/whats-new.html +1601 -725
  50. package/docs-site/en/windows.html +71 -63
  51. package/docs-site/en/workflows.html +68 -60
  52. package/docs-site/favicon.svg +9 -14
  53. package/docs-site/index.html +281 -220
  54. package/docs-site/mcp-approval.html +70 -62
  55. package/docs-site/mcp-auth.html +70 -62
  56. package/docs-site/mcp-servers.html +71 -63
  57. package/docs-site/mcp.html +70 -62
  58. package/docs-site/permissions.html +72 -64
  59. package/docs-site/profiles.html +72 -64
  60. package/docs-site/quickstart.html +145 -172
  61. package/docs-site/releases.json +4449 -0
  62. package/docs-site/runtime.html +73 -65
  63. package/docs-site/scope.html +73 -65
  64. package/docs-site/security.html +73 -65
  65. package/docs-site/team.html +71 -63
  66. package/docs-site/update.html +228 -0
  67. package/docs-site/whats-new.html +1605 -729
  68. package/docs-site/windows.html +75 -67
  69. package/docs-site/workflows.html +73 -65
  70. package/evals/private-holdout-v1/public-exposure.v2.json +1 -1
  71. package/package.json +1 -1
  72. package/packages/piagent-core/package.json +1 -1
  73. package/packages/piagent-webui/dist/client/assets/App-DBx4BU3F.js +5 -0
  74. package/packages/piagent-webui/dist/client/assets/LineReview-DzonwD-g.js +3 -0
  75. package/packages/piagent-webui/dist/client/assets/{MarkdownMessage-DeLo-xiz.js → MarkdownMessage-DchODuO7.js} +2 -2
  76. package/packages/piagent-webui/dist/client/assets/SessionInspectorDrawer-BHHNlct3.js +1 -0
  77. package/packages/piagent-webui/dist/client/assets/SettingsPage-DX28MsZA.js +1 -0
  78. package/packages/piagent-webui/dist/client/assets/TerminalPanel-C--BiN0p.js +2 -0
  79. package/packages/piagent-webui/dist/client/assets/{TerminalView-r9rG24IO.js → TerminalView-BML7uS6R.js} +3 -3
  80. package/packages/piagent-webui/dist/client/assets/WorkspaceCodeEditor-B7ieqDnt.js +2 -0
  81. package/packages/piagent-webui/dist/client/assets/WorkspaceExplorer-BOafuPU-.js +5 -0
  82. package/packages/piagent-webui/dist/client/assets/WorkspaceQuickOpen-CGoGfUPk.js +1 -0
  83. package/packages/piagent-webui/dist/client/assets/api-BUjrtT1B.js +1 -0
  84. package/packages/piagent-webui/dist/client/assets/index-C7Azrwpq.js +132 -0
  85. package/packages/piagent-webui/dist/client/assets/index-Dqb2hNan.css +1 -0
  86. package/packages/piagent-webui/dist/client/assets/tab-close-Crj8vsUq.js +1 -0
  87. package/packages/piagent-webui/dist/client/assets/ui-preferences-B3UfDp-5.js +1 -0
  88. package/packages/piagent-webui/dist/client/assets/vendor-Ch5hIe0W.js +136 -0
  89. package/packages/piagent-webui/dist/client/index.html +5 -8
  90. package/scripts/build-docs-site.mjs +205 -348
  91. package/scripts/check-public-wording.mjs +2 -1
  92. package/scripts/docs-site-icons.mjs +84 -0
  93. package/scripts/docs-site-nav.mjs +302 -0
  94. package/scripts/docs-site-releases.mjs +227 -0
  95. package/packages/piagent-webui/dist/client/assets/Alert-DGWhP2MM.js +0 -1
  96. package/packages/piagent-webui/dist/client/assets/Button-QItfZUNj.js +0 -1
  97. package/packages/piagent-webui/dist/client/assets/DialogTitle-CyaFPaiW.js +0 -3
  98. package/packages/piagent-webui/dist/client/assets/TerminalPanel-BG-DP_qm.js +0 -2
  99. package/packages/piagent-webui/dist/client/assets/Typography-B9om7Evq.js +0 -1
  100. package/packages/piagent-webui/dist/client/assets/WorkspaceCodeEditor-BnqaR3pK.js +0 -2
  101. package/packages/piagent-webui/dist/client/assets/WorkspaceExplorer-BIxwiGtl.js +0 -5
  102. package/packages/piagent-webui/dist/client/assets/WorkspaceQuickOpen-CK3dILhQ.js +0 -1
  103. package/packages/piagent-webui/dist/client/assets/index-DBUTrEXi.css +0 -1
  104. package/packages/piagent-webui/dist/client/assets/index-rlyRccut.js +0 -102
  105. package/packages/piagent-webui/dist/client/assets/tab-close-BoJRyBO_.js +0 -1
  106. package/packages/piagent-webui/dist/client/assets/ui-preferences-BO3AV7QE.js +0 -10
  107. package/packages/piagent-webui/dist/client/assets/useId-DEefKUAT.js +0 -124
package/docs-site/en/index.html CHANGED
@@ -1,276 +1,337 @@
1
1
  <!doctype html>
2
- <html lang="en" data-copy-success="Copied" data-copy-fallback="Select command">
2
+ <html lang="en" data-copy-success="Copied" data-copy-fallback="Select command" data-copy-label="Copy">
3
3
  <head>
4
4
  <meta charset="utf-8" />
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1" />
6
- <title>Pi Agent Platform Docs</title>
7
- <meta name="description" content="A coding agent for the whole team: one dashboard for Terminal and the browser, personal or company models, and a guard that checks every tool call." />
8
- <meta name="theme-color" content="#050505" />
6
+ <title>Pi Agent Platform — A coding agent for the whole team</title>
7
+ <meta name="description" content="A coding agent for the whole team: a guard checks every tool call, the team's Harness runs checks and review, one dashboard for Terminal and the browser." />
8
+ <meta name="theme-color" content="#09090b" media="(prefers-color-scheme: dark)" />
9
+ <meta name="theme-color" content="#fbfbf9" media="(prefers-color-scheme: light)" />
9
10
  <link rel="canonical" href="https://piagent.io.vn/en/" />
10
11
  <link rel="alternate" hreflang="vi" href="https://piagent.io.vn/" />
11
12
  <link rel="alternate" hreflang="en" href="https://piagent.io.vn/en/" />
12
13
  <link rel="alternate" hreflang="x-default" href="https://piagent.io.vn/" />
13
14
  <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
14
- <meta property="og:title" content="Pi Agent Platform Docs" />
15
- <meta property="og:description" content="A coding agent for the whole team: one dashboard for Terminal and the browser, personal or company models, and a guard that checks every tool call." />
15
+ <meta property="og:type" content="website" />
16
+ <meta property="og:title" content="Pi Agent Platform — A coding agent for the whole team" />
17
+ <meta property="og:description" content="A coding agent for the whole team: a guard checks every tool call, the team's Harness runs checks and review, one dashboard for Terminal and the browser." />
16
18
  <meta property="og:url" content="https://piagent.io.vn/en/" />
19
+ <meta property="og:image" content="https://piagent.io.vn/assets/og.png" />
20
+ <meta name="twitter:card" content="summary_large_image" />
21
+ <script>try{var t=localStorage.getItem("piagent-docs-theme");if(t==="light"||t==="dark")document.documentElement.dataset.theme=t}catch(e){}</script>
17
22
  <link rel="preconnect" href="https://fonts.googleapis.com" />
18
23
  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
19
24
  <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"
25
+ href="https://fonts.googleapis.com/css2?family=Inter:wght@400;450;500;550;600;650;700;750&family=JetBrains+Mono:wght@400;500;600;700&display=swap"
21
26
  rel="stylesheet"
22
27
  />
23
28
  <link rel="stylesheet" href="/assets/docs.css" />
24
29
  <script src="/assets/docs.js" defer></script>
25
30
  </head>
26
- <body>
31
+ <body class="home">
32
+ <svg width="0" height="0" style="position:absolute" aria-hidden="true"><symbol id="icon-apple" viewBox="0 0 24 24"><path d="M16 3.5c-1 .3-2.4 1.3-2.6 3 1.2.1 2.4-.8 2.6-3zM12 8c-1.5-1-5-1-6 2.5S6.5 19 9 20c1.2.5 2-.4 3-.4s1.8.9 3 .4c1.4-.6 2.5-2.7 3-4.5-2.5-1-2.8-4.6-.5-6-1.2-1.6-3.3-2-4.5-1.5z"/></symbol><symbol id="icon-arrow-right" viewBox="0 0 24 24"><path d="M5 12h14M13 6l6 6-6 6"/></symbol><symbol id="icon-box" viewBox="0 0 24 24"><path d="m12 3 8 4.5v9L12 21l-8-4.5v-9z"/><path d="m4 7.5 8 4.5 8-4.5M12 12v9"/></symbol><symbol id="icon-brain" viewBox="0 0 24 24"><path d="M9 4a3 3 0 0 0-3 3 3 3 0 0 0-2 5 3 3 0 0 0 2 5 3 3 0 0 0 3 3h0a2 2 0 0 0 2-2V6a2 2 0 0 0-2-2z"/><path d="M15 4a3 3 0 0 1 3 3 3 3 0 0 1 2 5 3 3 0 0 1-2 5 3 3 0 0 1-3 3h0a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2z"/></symbol><symbol id="icon-branch" viewBox="0 0 24 24"><circle cx="6" cy="5.5" r="2"/><circle cx="6" cy="18.5" r="2"/><circle cx="18" cy="7.5" r="2"/><path d="M6 7.5v9M18 9.5c0 4.5-5 4-11 7.5"/></symbol><symbol id="icon-building" viewBox="0 0 24 24"><rect x="4.5" y="3" width="15" height="18" rx="1.5"/><path d="M9 7h1.5M13.5 7H15M9 11h1.5M13.5 11H15M9 15h1.5M13.5 15H15M10 21v-3h4v3"/></symbol><symbol id="icon-camera" viewBox="0 0 24 24"><path d="M4 8h3l2-3h6l2 3h3v11H4z"/><circle cx="12" cy="13" r="3.5"/></symbol><symbol id="icon-chart" viewBox="0 0 24 24"><path d="M4 4v16h16"/><path d="M8.5 16v-5M12.5 16V8M16.5 16v-3"/></symbol><symbol id="icon-check" viewBox="0 0 24 24"><path d="m5 12 5 5 9-10"/></symbol><symbol id="icon-check-circle" viewBox="0 0 24 24"><circle cx="12" cy="12" r="9"/><path d="m8.5 12 2.5 2.5 4.5-5"/></symbol><symbol id="icon-clock" viewBox="0 0 24 24"><circle cx="12" cy="12" r="9"/><path d="M12 7v5l3 2"/></symbol><symbol id="icon-code" viewBox="0 0 24 24"><path d="m8 7-5 5 5 5M16 7l5 5-5 5M14 4l-4 16"/></symbol><symbol id="icon-copy" viewBox="0 0 24 24"><rect x="9" y="9" width="11" height="11" rx="2"/><path d="M5 15V6a2 2 0 0 1 2-2h9"/></symbol><symbol id="icon-cpu" viewBox="0 0 24 24"><rect x="6" y="6" width="12" height="12" rx="2"/><rect x="9.5" y="9.5" width="5" height="5" rx=".8"/><path d="M9 2.5V6M15 2.5V6M9 18v3.5M15 18v3.5M2.5 9H6M2.5 15H6M18 9h3.5M18 15h3.5"/></symbol><symbol id="icon-github" viewBox="0 0 24 24"><path d="M9 19c-4.5 1.5-4.5-2.5-6.5-3m13 6v-3.5a3 3 0 0 0-.9-2.4c3-.3 6.4-1.5 6.4-6.7a5.2 5.2 0 0 0-1.4-3.6 4.8 4.8 0 0 0-.1-3.6s-1.1-.3-3.7 1.4a12.6 12.6 0 0 0-6.6 0C6.6 1.9 5.5 2.2 5.5 2.2a4.8 4.8 0 0 0-.1 3.6A5.2 5.2 0 0 0 4 9.4c0 5.2 3.4 6.4 6.4 6.7a3 3 0 0 0-.9 2.4V22"/></symbol><symbol id="icon-hash" viewBox="0 0 24 24"><path d="M5 9h15M4 15h15M10 3 8 21M16 3l-2 18"/></symbol><symbol id="icon-home" viewBox="0 0 24 24"><path d="M3 10.5 12 3l9 7.5V20a1 1 0 0 1-1 1h-5v-6H9v6H4a1 1 0 0 1-1-1z"/></symbol><symbol id="icon-key" viewBox="0 0 24 24"><circle cx="8" cy="15" r="4"/><path d="m10.9 12.1 8.6-8.6M16.5 6.5l2.5 2.5M14 9l2 2"/></symbol><symbol id="icon-layers" viewBox="0 0 24 24"><path d="m12 3 9 5-9 5-9-5z"/><path d="m3 13 9 5 9-5"/><path d="m3 17.5 9 5 9-5" opacity=".55"/></symbol><symbol id="icon-list" viewBox="0 0 24 24"><path d="M9 6h11M9 12h11M9 18h11M4.5 6h.01M4.5 12h.01M4.5 18h.01"/></symbol><symbol id="icon-lock" viewBox="0 0 24 24"><rect x="4" y="11" width="16" height="10" rx="2"/><path d="M8 11V7a4 4 0 0 1 8 0v4"/></symbol><symbol id="icon-message" viewBox="0 0 24 24"><path d="M4 5h16v11H9l-5 4z"/></symbol><symbol id="icon-moon" viewBox="0 0 24 24"><path d="M20 14.5A8 8 0 1 1 9.5 4a6.5 6.5 0 0 0 10.5 10.5z"/></symbol><symbol id="icon-network" viewBox="0 0 24 24"><circle cx="12" cy="5" r="2.5"/><circle cx="5" cy="19" r="2.5"/><circle cx="19" cy="19" r="2.5"/><path d="M12 7.5V12m0 0-5.2 5.2M12 12l5.2 5.2"/></symbol><symbol id="icon-plug" viewBox="0 0 24 24"><path d="M9 3v4M15 3v4M6 7h12v4a6 6 0 0 1-12 0zM12 17v4"/></symbol><symbol id="icon-refresh" viewBox="0 0 24 24"><path d="M20 11A8 8 0 0 0 5.3 6.7M4 3v4h4"/><path d="M4 13a8 8 0 0 0 14.7 4.3M20 21v-4h-4"/></symbol><symbol id="icon-rocket" viewBox="0 0 24 24"><path d="M5.5 15.5C4 17 3.5 19.5 3.5 20.5c1 0 3.5-.5 5-2"/><path d="M9 15 6.5 12.5C8 8.5 11.5 4.5 20 4c-.5 8.5-4.5 12-8.5 13.5z"/><circle cx="14.5" cy="9.5" r="1.5"/></symbol><symbol id="icon-search" viewBox="0 0 24 24"><circle cx="11" cy="11" r="7"/><path d="m20 20-3.5-3.5"/></symbol><symbol id="icon-server" viewBox="0 0 24 24"><rect x="3" y="4" width="18" height="7" rx="2"/><rect x="3" y="13" width="18" height="7" rx="2"/><path d="M7 7.5h.01M7 16.5h.01"/></symbol><symbol id="icon-shield" viewBox="0 0 24 24"><path d="M12 3 4.5 6v5.5c0 4.8 3.2 8.2 7.5 9.5 4.3-1.3 7.5-4.7 7.5-9.5V6z"/></symbol><symbol id="icon-shield-check" viewBox="0 0 24 24"><path d="M12 3 4.5 6v5.5c0 4.8 3.2 8.2 7.5 9.5 4.3-1.3 7.5-4.7 7.5-9.5V6z"/><path d="m9 12 2.2 2.2L15.5 10"/></symbol><symbol id="icon-sliders" viewBox="0 0 24 24"><path d="M4 7h9M17 7h3M4 17h3M11 17h9"/><circle cx="15" cy="7" r="2"/><circle cx="9" cy="17" r="2"/></symbol><symbol id="icon-sparkles" viewBox="0 0 24 24"><path d="M11 3c.6 4.6 2.4 6.4 7 7-4.6.6-6.4 2.4-7 7-.6-4.6-2.4-6.4-7-7 4.6-.6 6.4-2.4 7-7z"/><path d="M19 15v5M16.5 17.5h5"/></symbol><symbol id="icon-sun" viewBox="0 0 24 24"><circle cx="12" cy="12" r="4"/><path d="M12 2.5v2M12 19.5v2M4.6 4.6 6 6M18 18l1.4 1.4M2.5 12h2M19.5 12h2M4.6 19.4 6 18M18 6l1.4-1.4"/></symbol><symbol id="icon-target" viewBox="0 0 24 24"><circle cx="12" cy="12" r="9"/><circle cx="12" cy="12" r="5"/><circle cx="12" cy="12" r="1"/></symbol><symbol id="icon-terminal" viewBox="0 0 24 24"><rect x="3" y="4" width="18" height="16" rx="2.5"/><path d="m7.5 9.5 3 2.5-3 2.5M13 15h4"/></symbol><symbol id="icon-users" viewBox="0 0 24 24"><circle cx="9" cy="8" r="3.5"/><path d="M2.5 20a6.5 6.5 0 0 1 13 0"/><path d="M16 4.5a3.5 3.5 0 0 1 0 7M18 14a6 6 0 0 1 3.5 6"/></symbol><symbol id="icon-windows" viewBox="0 0 24 24"><path d="M3.5 5.5 10.5 4.5v7h-7zM13 4.2 20.5 3v8.5H13zM3.5 13h7v7l-7-1zM13 13h7.5v8.5L13 20.3z"/></symbol><symbol id="icon-wrench" viewBox="0 0 24 24"><path d="M15 6.5a4.5 4.5 0 0 1-6 6l-5 5L6.5 20l5-5a4.5 4.5 0 0 0 6-6L15 11.5l-2.5-2.5z"/></symbol></svg>
33
+ <a class="skip-link" href="#content">Skip to content</a>
27
34
  <header class="topbar">
28
35
  <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>
36
+ <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
37
+ <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
31
38
  </a>
39
+ <a class="version-badge" href="/en/whats-new" data-docs-version="v1.42.0" title="v1.42.0 docs · EN"><span class="dot"></span>v1.42.0</a>
40
+ <nav class="top-nav" aria-label="Documentation">
41
+ <a href="/en/quickstart">Docs</a>
42
+ <a href="/en/whats-new">Changelog</a>
43
+ <a href="/en/benchmark">Benchmark</a>
44
+ </nav>
45
+ <span class="top-spacer"></span>
46
+ <button class="search-trigger" type="button" data-search aria-label="Search documentation"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-search"/></svg><span>Search the docs…</span><kbd>⌘K</kbd></button>
32
47
  <div class="top-actions">
33
- <span class="pill"><span class="pill-dot"></span>v1.41.0 docs · EN</span>
34
- <nav class="language-switch" aria-label="Language">
35
- <a class="language-option" href="/" hreflang="vi" lang="vi">VI</a>
36
- <a class="language-option current" href="/en/" 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>
48
+ <nav class="language-switch" aria-label="Language"><a class="language-option" href="/" hreflang="vi" lang="vi">VI</a><a class="language-option current" href="/en/" hreflang="en" lang="en" aria-current="true">EN</a></nav>
49
+ <button class="icon-button theme-toggle" type="button" data-theme-toggle aria-label="Switch light/dark theme"><svg class="icon icon-moon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-moon"/></svg><svg class="icon icon-sun" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-sun"/></svg></button>
50
+ <a class="icon-button" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Open GitHub repository"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-github"/></svg></a>
46
51
  </div>
47
52
  </header>
48
53
 
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>
54
+ <main id="content" class="home-main" data-article>
55
+ <section class="hero">
56
+ <div class="hero-bg" aria-hidden="true"></div>
57
+ <div class="hero-glow" aria-hidden="true"></div>
58
+ <div class="home-wrap">
59
+ <a class="hero-pill" href="/en/whats-new#v1-42-0"><b>v1.42.0</b><span>A redesigned dashboard and older messages that load without jumping</span><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></a>
60
+ <h1>A coding agent for the whole team, <span class="grad">checked at every step.</span></h1>
61
+ <p class="hero-sub">A guard stops risky tool calls before they run. The team's Harness runs checks and has a subagent review the change. One dashboard for Terminal and the browser, with your model or the company's.</p>
62
+ <div class="hero-cta">
63
+ <div class="install-box"><span class="prompt" aria-hidden="true">$</span><code>npm i -g @piagent/platform</code><button class="clip-btn" type="button" data-clip="npm install -g @piagent/platform&#10;piagent-setup" aria-label="Copy the install command"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-copy"/></svg></button></div>
64
+ <a class="button primary lg" href="/en/quickstart">Get started <svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></a>
65
+ <a class="button lg" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-github"/></svg> GitHub</a>
66
+ </div>
67
+ <p class="hero-note"><span>MIT</span><span>Node.js ≥ 22.19</span><span>macOS · Linux · Windows (WSL2)</span></p>
57
68
 
58
- <nav aria-label="Documentation">
59
- <div class="nav-group">
60
- <p class="nav-title">Get started</p>
61
- <a class="nav-link current" href="/en/" aria-current="page">Overview</a>
62
- <a class="nav-link" href="/en/ecosystem">Ecosystem</a>
63
- <a class="nav-link" href="/en/quickstart">Quickstart</a>
64
- <a class="nav-link" href="/en/windows">Windows</a>
65
- <a class="nav-link" href="/en/whats-new">What’s new</a>
66
- <a class="nav-link" href="/en/scope">Platform scope</a>
67
- </div>
68
- <div class="nav-group">
69
- <p class="nav-title">Build</p>
70
- <a class="nav-link" href="/en/profiles">Project profiles</a>
71
- <a class="nav-link" href="/en/permissions">Permission modes</a>
72
- <a class="nav-link" href="/en/commands">Command catalog</a>
73
- <a class="nav-link" href="/en/workflows">Workflows</a>
74
- </div>
75
- <div class="nav-group">
76
- <p class="nav-title">MCP</p>
77
- <a class="nav-link" href="/en/mcp">MCP overview</a>
78
- <a class="nav-link" href="/en/mcp-servers">Server management</a>
79
- <a class="nav-link" href="/en/mcp-auth">Authentication</a>
80
- <a class="nav-link" href="/en/mcp-approval">Approval gate</a>
69
+ <div class="demo" data-reveal>
70
+ <div class="window" aria-label="Illustration of one company-mode turn" role="img">
71
+ <div class="window-bar" aria-hidden="true"><i></i><i></i><i></i><span class="title">piagent dashboard · shop-api</span></div>
72
+ <div class="window-body" aria-hidden="true">
73
+ <div class="window-side">
74
+ <p>Conversations</p>
75
+ <div class="item active"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-message"/></svg><span>Fix money rounding</span><i class="status run"></i></div>
76
+ <div class="item"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-message"/></svg><span>Paginate /orders</span><i class="status ok"></i></div>
77
+ <div class="item"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-message"/></svg><span>Read the project</span><i class="status ok"></i></div>
78
+ <p style="margin-top:18px">Harness</p>
79
+ <div class="item"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-shield-check"/></svg><span>check · review</span></div>
80
+ <div class="item"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-branch"/></svg><span>fix/invoice-rounding</span></div>
81
81
  </div>
82
- <div class="nav-group">
83
- <p class="nav-title">Operate</p>
84
- <a class="nav-link" href="/en/security">Security model</a>
85
- <a class="nav-link" href="/en/architecture">Architecture</a>
86
- <a class="nav-link" href="/en/context-engine">Context Engine</a>
87
- <a class="nav-link" href="/en/benchmark">Benchmark</a>
88
- <a class="nav-link" href="/en/runtime">Runtime tools</a>
89
- <a class="nav-link" href="/en/team">Team usage</a>
82
+ <div class="term" data-term>
83
+ <div class="term-line you"><span class="g">›</span><span data-type="Fix the invoice rounding bug, run the tests, then push."></span><span class="caret"></span></div>
84
+ <div class="term-line dim" data-wait="700"><span class="g">·</span><span>Read src/billing/invoice.ts, tests/invoice.test.ts</span></div>
85
+ <div class="term-line warn"><span class="g">✕</span><span>Guard blocked: read <b>.env</b> · protected file</span></div>
86
+ <div class="term-line mint"><span class="g">✎</span><span>Edit src/billing/invoice.ts <span class="ok">+12</span> <span class="warn">−3</span></span></div>
87
+ <div class="term-line" data-wait="800"><span class="g ok">▶</span><span>npm test <span class="dim">— sandbox, no network</span> <span class="ok">48 passed</span></span></div>
88
+ <div class="term-line" data-wait="800"><span class="g lime">◆</span><span>Review · subagent read the diff: <span class="ok">no blocking issue</span></span></div>
89
+ <div class="term-result" data-wait="700"><span class="ok">✓</span> Check passed on the final code · Review found no blocking issue</div>
90
+ <div class="term-card" data-wait="900">The agent wants to run <b>git push origin fix/invoice-rounding</b>
91
+ <div class="row"><span class="chip yes">Allow once</span><span class="chip">Deny</span></div>
92
+ </div>
90
93
  </div>
91
- </nav>
92
- </aside>
94
+ </div>
95
+ </div>
96
+ </div>
93
97
 
94
- <main>
95
- <div class="content-shell" data-article>
96
- <section class="hero">
97
- <p class="eyebrow">Piagent 1.41.0</p>
98
- <h1>A coding agent for the whole team, checked at every step.</h1>
99
- <p>
100
- One dashboard for Terminal and the browser. Use models with your own account, or the company's models through Agent Watch and Agent Studio. The guard checks every tool call; in company mode the team's Harness asks for checks, has a subagent review the change and reports the outcome right under the answer.
101
- </p>
102
- <div class="owner-strip" aria-label="Project information">
103
- <span class="owner-label">Project links</span>
104
- <a href="https://piagent.io.vn/en/" target="_blank" rel="noopener noreferrer">Docs · piagent.io.vn</a>
105
- <a href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer">GitHub · Vt-mmm/piagent</a>
106
- <a href="https://www.facebook.com/vinhtam0544/" target="_blank" rel="noopener noreferrer">Facebook · Vinh Tam</a>
107
- </div>
108
- <div class="hero-actions">
109
- <a class="button primary" href="/en/quickstart">Get started</a>
110
- <a class="button" href="/en/ecosystem">Ecosystem</a>
111
- <a class="button" href="/en/whats-new">What’s new in 1.41.0</a>
112
- <a class="button" href="/en/commands">View commands</a>
98
+ <div class="proof" data-reveal>
99
+ <div><strong><span data-count="54">54</span><em>/54</em></strong><span>tasks resolved in the production benchmark</span><small>codex-cli, same model: 48/54</small></div>
100
+ <div><strong>−<span data-count="61">61</span><em>%</em></strong><span>fresh tokens on the same workload</span><small>95% confidence: at least −51.6%</small></div>
101
+ <div><strong><span data-count="52">52</span><em>/52</em></strong><span>secret patterns redacted from output</span><small>0/30 ordinary texts redacted by mistake</small></div>
102
+ <div><strong><span data-count="115">115</span></strong><span>releases since 2026-07-21</span><small>4,400+ automated tests on macOS and Linux</small></div>
103
+ </div>
113
104
  </div>
114
105
  </section>
115
106
 
116
- <section class="section">
117
- <p class="section-kicker">Release 1.9.0</p>
118
- <h2 id="release-1-9-0">One company-mode turn</h2>
119
- <p class="section-lead">You write the request. The agent reads, edits and runs the tests in a sandbox; a subagent reviews the change; the last line states the outcome. 13 of 13 live scenarios pass on the final install, and 27 of 27 browser tests.</p>
120
- <figure class="shot">
121
- <img src="/assets/shots/company-run-done.jpg" alt="Piagent dashboard: a company-mode turn with read, edit and test steps and the line A check passed on the final code, Review found no blocking issue" width="1600" height="1000">
122
- <figcaption>The Piagent dashboard in company mode. See the whole picture in <a href="/en/ecosystem">Ecosystem</a> and every change in <a href="/en/whats-new">What’s new</a>.</figcaption>
123
- </figure>
124
- </section>
125
-
126
- <section class="section">
127
- <p class="section-kicker">Production V1 · historical evidence from v1.6.0</p>
128
- <h2 id="evidence">Measured, not asserted</h2>
129
- <p class="section-lead">Release-bound run <code>production-v1-20260824T040017Z-05b7cf</code> measured 108 sessions on GPT-5.6 Luna Medium at tag <code>v1.6.0</code>, exact commit <code>3bba8f0b3ff521bc2a355e1f6bef6d1bbdc09511</code>, with Piagent compared against <code>codex-cli</code>.</p>
130
-
131
- <div class="benchmark-metrics" aria-label="Headline benchmark numbers">
132
- <div class="benchmark-metric">
133
- <span>Release evidence</span>
134
- <strong>v1.6.0</strong>
135
- <small>exact commit 3bba8f0</small>
136
- </div>
137
- <div class="benchmark-metric">
138
- <span>Tasks resolved</span>
139
- <strong>54/54</strong>
140
- <small>Piagent; codex-cli resolved 48/54</small>
141
- </div>
142
- <div class="benchmark-metric">
143
- <span>Fresh tokens</span>
144
- <strong>-61.43%</strong>
145
- <small>primary fixed-workload family ratio 0.3857</small>
107
+ <section class="home-section">
108
+ <div class="home-wrap">
109
+ <div class="home-head" data-reveal>
110
+ <p class="section-kicker">Why it is different</p>
111
+ <h2 id="different">The agent works fast. The platform keeps it right.</h2>
112
+ <p>Every tool call goes through the guard, every risky action waits for you, and in company mode a turn is only reported done once checks ran on the final code.</p>
146
113
  </div>
147
- <div class="benchmark-metric">
148
- <span>Usage evidence</span>
149
- <strong>108/108 exact</strong>
150
- <small>zero retries</small>
114
+ <div class="bento" data-spotlight>
115
+ <article class="tile wide" data-reveal>
116
+ <span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-shield-check"/></svg></span>
117
+ <h3>A guard on every tool call</h3>
118
+ <p>Fails closed: protected files, permission profiles, oversized files, edits on a stale read. When in doubt it blocks, it does not guess.</p>
119
+ <div class="mini"><span class="x">✕</span> read .env <span class="d">— protected path</span><br><span class="x">✕</span> edit src/app.ts <span class="d">— read it again first</span><br><span class="w">!</span> git push <span class="d">— waits for one approval</span><br><span class="ok">✓</span> npm test <span class="d">— allowed</span></div>
120
+ </article>
121
+ <article class="tile wide" data-reveal>
122
+ <span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check-circle"/></svg></span>
123
+ <h3>The team's Harness checks and reviews</h3>
124
+ <p>Studio sets the plan, the checks and the review rounds for the whole team. A subagent reads the diff on its own; the outcome sits right under the answer.</p>
125
+ <div class="chips"><span>plan</span><span>check</span><span>review</span><span>main · research · review</span></div>
126
+ </article>
127
+ <article class="tile" data-reveal>
128
+ <span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-key"/></svg></span>
129
+ <h3>One approval at a time</h3>
130
+ <p>Push, publish and network commands run only after you press <strong>Allow once</strong>. There is no "always allow".</p>
131
+ </article>
132
+ <article class="tile" data-reveal>
133
+ <span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-box"/></svg></span>
134
+ <h3>A sandbox in company mode</h3>
135
+ <p>Seatbelt on macOS, bubblewrap on Linux and WSL2: no network, no Keychain, no <code>.env</code> or SSH keys.</p>
136
+ </article>
137
+ <article class="tile" data-reveal>
138
+ <span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-code"/></svg></span>
139
+ <h3>The dashboard is an editor</h3>
140
+ <p>Folder tree, editor, terminal, hunk-by-hunk review, a Timeline to restore turns and <code>/undo</code>. 13 colour themes.</p>
141
+ </article>
142
+ <article class="tile" data-reveal>
143
+ <span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-clock"/></svg></span>
144
+ <h3>Long tasks finish</h3>
145
+ <p>A passing model error is retried; a Studio update is waited out, then work resumes. One turn can run for 24 hours.</p>
146
+ </article>
147
+ <article class="tile" data-reveal>
148
+ <span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-brain"/></svg></span>
149
+ <h3>Team memory</h3>
150
+ <p>The agent remembers the team's decisions and rules per repository and branch; <code>memory_ask</code> answers with sources.</p>
151
+ </article>
152
+ <article class="tile" data-reveal>
153
+ <span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-camera"/></svg></span>
154
+ <h3>Front-end change reports</h3>
155
+ <p>Before and after screenshots, each change in a numbered red frame, with checks and E2E. Shown right in Documents.</p>
156
+ </article>
151
157
  </div>
152
158
  </div>
159
+ </section>
153
160
 
154
- <div class="benchmark-legend" aria-label="Chart legend">
155
- <span><i class="piagent-swatch"></i>Piagent</span>
156
- <span><i class="codex-swatch"></i>codex-cli</span>
161
+ <section class="home-section">
162
+ <div class="home-wrap">
163
+ <div class="home-head center" data-reveal>
164
+ <p class="section-kicker">One turn</p>
165
+ <h2 id="one-turn">You say what you need. The rest is verified.</h2>
166
+ </div>
167
+ <div class="flow" data-flow>
168
+ <div class="flow-step"><span class="flow-dot"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-message"/></svg></span><div><h3>Ask</h3><p>Plain language, no task contract or workflow command.</p></div></div>
169
+ <div class="flow-step"><span class="flow-dot"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-code"/></svg></span><div><h3>Read and edit</h3><p>The agent reads the files it needs and edits with a clear diff.</p></div></div>
170
+ <div class="flow-step"><span class="flow-dot"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-shield-check"/></svg></span><div><h3>Guard checks</h3><p>Every tool call meets the policy; risky ones wait for you.</p></div></div>
171
+ <div class="flow-step"><span class="flow-dot"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check-circle"/></svg></span><div><h3>Check and review</h3><p>Tests run on the final code; a subagent reviews on its own.</p></div></div>
172
+ <div class="flow-step"><span class="flow-dot"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-list"/></svg></span><div><h3>Report</h3><p>One closing line: done, stopped part-way, or failed.</p></div></div>
173
+ </div>
157
174
  </div>
175
+ </section>
158
176
 
159
- <div class="benchmark-usage-chart" aria-label="Fixed-workload family fresh-token ratio: Piagent 38.57 percent, codex-cli baseline 100 percent; tasks resolved: Piagent 54 of 54, codex-cli 48 of 54">
160
- <div class="benchmark-usage-group">
161
- <h3>Fixed-workload family fresh-token ratio</h3>
162
- <div class="benchmark-usage-row"><span>Piagent</span><div class="benchmark-track"><i class="piagent-bar" style="--bar-size: 38.57%"></i></div><strong>0.3857</strong></div>
163
- <div class="benchmark-usage-row"><span>codex-cli</span><div class="benchmark-track"><i class="codex-bar" style="--bar-size: 100%"></i></div><strong>1.0000</strong></div>
177
+ <section class="home-section">
178
+ <div class="home-wrap">
179
+ <div class="home-head center" data-reveal>
180
+ <p class="section-kicker">Real screens</p>
181
+ <h2 id="screens">Captured from a running dashboard</h2>
164
182
  </div>
165
- <div class="benchmark-usage-group">
166
- <h3>Tasks resolved</h3>
167
- <div class="benchmark-usage-row"><span>Piagent</span><div class="benchmark-track"><i class="piagent-bar" style="--bar-size: 100%"></i></div><strong>54/54</strong></div>
168
- <div class="benchmark-usage-row"><span>codex-cli</span><div class="benchmark-track"><i class="codex-bar" style="--bar-size: 88.89%"></i></div><strong>48/54</strong></div>
183
+ <div data-gallery data-reveal>
184
+ <div class="gallery-tabs">
185
+ <div class="tab-list" role="tablist" aria-label="Choose a screenshot">
186
+ <button type="button" role="tab" aria-selected="true" data-shot="/assets/shots/company-run-done.jpg" data-alt="A company-mode turn: read, edit, run tests; the closing line says the check passed and review found no blocking issue" data-caption="A company-mode turn: read, edit, run tests; the closing line records check and review.">Company turn</button>
187
+ <button type="button" role="tab" aria-selected="false" data-shot="/assets/shots/company-review-running.jpg" data-alt="A subagent reviewing the change during a company turn" data-caption="A subagent reviews the change while the turn is still running.">Review</button>
188
+ <button type="button" role="tab" aria-selected="false" data-shot="/assets/shots/network-approval.jpg" data-alt="Approval card for a network command, showing the exact command" data-caption="A network command waits for approval; the card shows the exact command.">Network approval</button>
189
+ <button type="button" role="tab" aria-selected="false" data-shot="/assets/shots/personal-edit-test.jpg" data-alt="Personal mode: editing code and running tests" data-caption="Personal mode: your model, the same guard.">Personal</button>
190
+ <button type="button" role="tab" aria-selected="false" data-shot="/assets/shots/hub-source-review.jpg" data-alt="Agent Inspector: working tree changes, inline diff and an open-in-editor button" data-caption="Source Changes: per-file diff, inline or side by side, review and stage hunk by hunk.">Source Changes</button>
191
+ <button type="button" role="tab" aria-selected="false" data-shot="/assets/shots/hub-palette.jpg" data-alt="Command palette listing commands and colour themes" data-caption="⌘K palette: every command, setting and the 13 colour themes in one search box.">Palette</button>
192
+ <button type="button" role="tab" aria-selected="false" data-shot="/assets/shots/hub-new-chat.jpg" data-alt="New conversation page with project and model pickers and starter tasks" data-caption="New conversation: pick the project and model, or click a starter task.">New chat</button>
193
+ </div>
194
+ </div>
195
+ <figure class="gallery-frame">
196
+ <img src="/assets/shots/company-run-done.jpg" alt="A company-mode turn: read, edit, run tests; the closing line says the check passed and review found no blocking issue" width="1600" height="1000" loading="lazy" decoding="async" style="transition:opacity .2s">
197
+ <figcaption>A company-mode turn: read, edit, run tests; the closing line records check and review.</figcaption>
198
+ </figure>
169
199
  </div>
170
200
  </div>
171
-
172
- <p>The primary fixed-workload family ratio is <strong>0.3857</strong>, with a 95% confidence interval of <strong>0.3073–0.4840</strong>. The point estimate is 61.43% lower, while the upper confidence bound supports the conservative statement that Piagent used at least 51.60% fewer fresh tokens on this predeclared production-v1 workload and exact release. Usage was exact for all 108 sessions and no retry occurred. <a href="/en/benchmark">See the benchmark methodology and evidence boundary</a>.</p>
173
201
  </section>
174
202
 
175
- <section class="section">
176
- <h2 id="install">Install with two commands</h2>
177
- <p>Requires Node.js <span class="inline-code">&gt;=22.19.0</span>. Run these commands from the project you want to configure.</p>
178
- <pre><code>npm install -g @piagent/platform
179
- piagent-setup</code></pre>
180
- <p><span class="inline-code">piagent-setup</span> 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 <span class="inline-code">--no-mcp</span>, <span class="inline-code">--no-subagents</span>, or <span class="inline-code">--global-only</span>. See the <a href="/en/quickstart">Quickstart</a> for the complete flow.</p>
203
+ <section class="home-section">
204
+ <div class="home-wrap">
205
+ <div class="home-head" data-reveal>
206
+ <p class="section-kicker">Two modes</p>
207
+ <h2 id="two-modes">One dashboard, two ways to use models</h2>
208
+ <p>Switching modes does not change how you work: the same guard, the same history across Terminal and the browser.</p>
209
+ </div>
210
+ <div class="modes">
211
+ <article class="mode" data-reveal>
212
+ <div class="mode-head"><span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-users"/></svg></span><h3>Personal</h3><code>pi</code></div>
213
+ <p>Sign in with your own model account. Keys stay on your machine.</p>
214
+ <ul class="checks">
215
+ <li><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check"/></svg><span>Pick any model and thinking level</span></li>
216
+ <li><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check"/></svg><span>The same guard and protected paths as company mode</span></li>
217
+ <li><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check"/></svg><span>Push and publish still wait for approval</span></li>
218
+ <li><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check"/></svg><span><code>piagent dashboard</code> opens the web interface</span></li>
219
+ </ul>
220
+ </article>
221
+ <article class="mode featured" data-reveal>
222
+ <div class="mode-head"><span class="tile-icon"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-building"/></svg></span><h3>Company</h3><code>piagent studio --web</code></div>
223
+ <p>Agent Watch keeps the company key in Keychain; Agent Studio picks the models and the Harness for the team.</p>
224
+ <ul class="checks">
225
+ <li><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check"/></svg><span>The model never sees the key</span></li>
226
+ <li><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check"/></svg><span>Sandbox without network, opened one approval at a time</span></li>
227
+ <li><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check"/></svg><span>Checks and review run by the Harness</span></li>
228
+ <li><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-check"/></svg><span>Usage, budgets and wrong-project warnings in Studio</span></li>
229
+ </ul>
230
+ </article>
231
+ </div>
232
+ </div>
181
233
  </section>
182
234
 
183
- <section class="section">
184
- <h2 id="where-to-start">Where to start</h2>
185
- <div class="card-grid">
186
- <a class="doc-card" href="/en/whats-new">
187
- <span class="card-kicker">Release 1.41.0</span>
188
- <h3>What’s new</h3>
189
- <p>Front-end change reports: before/after screenshots framed in red, business and logic changes and check results, right in Documents; in 1.40.0: local projects without a remote are reported to Studio too, and members see every kind of project warning (Studio 0.40.0); in 1.39.0: warnings when a key works in the wrong project (Studio 0.39.0), and the dashboard keeps its language and theme across restarts; in 1.38.2: a VS Code-style folder tree, colour themes (Dracula, Nord…), and an editor and terminal that stay in view; in 1.38.1: the dashboard becomes an editor: file edits, terminals, inline hunk review and turn restore; Bypass that asks nothing, in company conversations too when the Harness allows it; in 1.37.1: a run Studio did not confirm closed is no longer recorded closed, a helper whose close fails keeps its answer, and team-memory lessons name the right command; in 1.37.0: an answer cut mid-stream no longer stops a long task, and <code>piagent studio --rpc</code>; in 1.36.1: a moment when Agent Watch cannot reach Studio no longer stops a task; in 1.36.0: team memory learns from what went wrong: Studio rates what memory handed over, a repeated command failure becomes a lesson; in 1.35: long tasks go on when Studio is updated or the model has a passing error; in 1.34: helpers report how their work ended, Agent Watch tells you when you are needed; in 1.33.0: runs on Pi 1.3.0; in 1.32.1: Bypass is kept after a reload, and a tab in use no longer signs out after 8 hours; in 1.32.0: a failed or stopped answer ends at Studio too; in 1.31.1: <code>memory_ask</code> right after an update; in 1.31.0: Team memory follows the branch and the team's rules, with <code>memory_ask</code>; in 1.30.1: no model names in the company Terminal; running <code>piagent studio</code> in the home folder now says to open a project folder; in 1.30.0: large contexts reach Studio over slow links and the company Terminal reads like the dashboard; in 1.29.0: the company Terminal gets its own look and Stop no longer breaks the conversation; in 1.28.3: Agent Watch updating itself no longer interrupts the company Terminal; in 1.28.2: no more “binding changed” right after an update; in 1.28.1: the company Terminal and personal Pi stop stepping on each other (no duplicate Piagent, no old company config, company chats stay in piagent studio); in 1.28.0: team memory v2; in 1.27.1: team memory keeps working while the agent calls the model; in 1.27.0: team memory, company agents remember the team's decisions and rules in each repository; in 1.26.1: a conversation is renamed while its turn runs; in 1.26.0: the Terminal's / commands and shortcuts in the dashboard, /undo for the agent's last turn, dev servers that stay up across turns; in 1.25.0: when the machine lacks something the agent asks, and the approved command runs (run_on_host outside the sandbox, start_docker in the same conversation); in 1.24.0: choose Fast on the new chat page for company conversations, and the Fast switch turns amber while on; in 1.23.1: an agent's question waits at the end of the conversation, right above the composer, and reads more easily; in 1.23.0: a Fast switch for company conversations where the Harness allows it, failed tools reported to Studio (Logs → Tool lỗi), new conversations send their first message after a Harness change; in 1.22.1: the dashboard no longer keeps loading when a project is on a Windows drive seen from WSL (/mnt/d…) or the company runtime does not answer; in 1.22.0: attach any source or text file (.html, .css, .ts, .py, Dockerfile…); in 1.21.1: Bypass can be turned on while a turn runs and stays on after a reload; in 1.21.0: questions and approvals one card at a time (the main agent's first), a notification at the top right when another conversation finishes or waits for you, Studio logs each compaction; in 1.20.0: package installs in the company sandbox no longer ask (npm, PyPI, Go, Maven, Gradle… through a registry-only proxy); in 1.19.0: company tasks with a checklist are carried to the end, every turn says whether it finished, stopped midway or failed, Docker in the company sandbox, folders with several repositories; in 1.18.0: switch the Git branch from the dashboard, retries for passing failures, Claude Haiku 5.5; in 1.17.0: the dashboard shows each project's Git branch; in 1.16.3: an updated dashboard keeps checking for releases; in 1.16.2: the Terminal says what the dashboard says: update question, /bypass, failures and Harness notes in Vietnamese; in 1.16.1: new releases are announced in a dialog and checked every hour, dashboard tabs stay signed in; in 1.16.0: Bypass for company conversations, Harness changes never interrupt you; in 1.15.2: long conversations shrink again; in 1.15.1: Studio sees what each model call is for, conversations in one folder keep their changes apart; in 1.15.0: a refused subagent says why; in 1.14: updates keep the models you chose; in 1.13: conversations keep their place, the agent's notes are formatted, Piagent on Windows through WSL2: a bubblewrap sandbox for company conversations and Agent Watch for Windows; in 1.12: @ picks files and folders on the Mac, skills and commands run from /, and forked company conversations take messages.</p>
190
- </a>
191
- <a class="doc-card" href="/en/ecosystem">
192
- <span class="card-kicker">Get started</span>
193
- <h3>Ecosystem</h3>
194
- <p>Piagent, Agent Watch and Agent Studio: what runs where, and when to use personal or company mode.</p>
195
- </a>
196
- <a class="doc-card" href="/en/quickstart">
197
- <span class="card-kicker">Get started</span>
198
- <h3>Quickstart</h3>
199
- <p>Install, open a repository, choose its profile and permissions, then make the first request in plain language.</p>
200
- </a>
201
- <a class="doc-card" href="/en/scope">
202
- <span class="card-kicker">Get started</span>
203
- <h3>Platform scope</h3>
204
- <p>Why this repository exists alongside general coding agents, and which operating concerns it owns.</p>
205
- </a>
206
- <a class="doc-card" href="/en/profiles">
207
- <span class="card-kicker">Build</span>
208
- <h3>Project profiles</h3>
209
- <p>Choose the operating profile for a repository: protected paths, verification commands, and granted capabilities.</p>
210
- </a>
211
- <a class="doc-card" href="/en/mcp">
212
- <span class="card-kicker">MCP</span>
213
- <h3>MCP</h3>
214
- <p>Four configuration layers, pinned presets, server management, authentication readiness, and repository approval gates.</p>
215
- </a>
216
- <a class="doc-card" href="/en/security">
217
- <span class="card-kicker">Operate</span>
218
- <h3>Security model</h3>
219
- <p>A policy enforcement layer, not an OS sandbox, with explicit claims about what is and is not controlled.</p>
220
- </a>
221
- <a class="doc-card" href="/en/benchmark">
222
- <span class="card-kicker">Operate</span>
223
- <h3>Production benchmark</h3>
224
- <p>Quality, safety, workflow, and token evidence from 108 sessions compared with the <code>codex-cli</code> surface.</p>
225
- </a>
226
- <a class="doc-card" href="/en/commands">
227
- <span class="card-kicker">Build</span>
228
- <h3>Command catalog</h3>
229
- <p>Slash commands and terminal commands grouped by the job they perform.</p>
230
- </a>
235
+ <section class="home-section">
236
+ <div class="home-wrap">
237
+ <div class="home-head" data-reveal>
238
+ <p class="section-kicker">Install</p>
239
+ <h2 id="install">Running in two minutes</h2>
240
+ <p><code>piagent-setup</code> installs the exact Pi release this version pins, initializes the project and runs the doctor.</p>
241
+ </div>
242
+ <div class="tabs" data-tabs="os" data-reveal>
243
+ <div class="tab-list" role="tablist" aria-label="Operating system">
244
+ <button type="button" role="tab" data-tab="macos" aria-selected="true"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-apple"/></svg> macOS · Linux</button>
245
+ <button type="button" role="tab" data-tab="windows" aria-selected="false" tabindex="-1"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-windows"/></svg> Windows</button>
246
+ </div>
247
+ <div class="tab-panel" data-panel="macos">
248
+ <div class="install-grid">
249
+ <div class="install-step"><span class="num">01</span><h3>Install</h3><p>Run it in the project folder.</p>
250
+ <div class="command-card"><header><span>bash</span><button class="clip-btn" type="button" data-clip="npm install -g @piagent/platform&#10;piagent-setup">Copy</button></header>
251
+ <pre><code>npm install -g @piagent/platform
252
+ piagent-setup</code></pre></div></div>
253
+ <div class="install-step"><span class="num">02</span><h3>Open</h3><p>Terminal, or the dashboard in your browser.</p>
254
+ <div class="command-card"><header><span>bash</span><button class="clip-btn" type="button" data-clip="piagent dashboard">Copy</button></header>
255
+ <pre><code>piagent dashboard
256
+ pi # Terminal</code></pre></div></div>
257
+ <div class="install-step"><span class="num">03</span><h3>Update</h3><p>The dashboard tells you about new releases every hour.</p>
258
+ <div class="command-card"><header><span>bash</span><button class="clip-btn" type="button" data-clip="piagent-update">Copy</button></header>
259
+ <pre><code>piagent-update</code></pre></div></div>
260
+ </div>
261
+ </div>
262
+ <div class="tab-panel" data-panel="windows" hidden>
263
+ <div class="install-grid">
264
+ <div class="install-step span-2"><span class="num">01</span><h3>One PowerShell command</h3><p>Installs WSL2, Ubuntu, Piagent and Agent Watch, and adds Piagent to the Start menu. Run it again to update.</p>
265
+ <div class="command-card"><header><span>PowerShell</span><button class="clip-btn" type="button" data-clip="irm https://raw.githubusercontent.com/Vt-mmm/agentwatch/main/windows/setup.ps1 | iex">Copy</button></header>
266
+ <pre><code>irm https://raw.githubusercontent.com/Vt-mmm/agentwatch/main/windows/setup.ps1 | iex</code></pre></div></div>
267
+ <div class="install-step"><span class="num">02</span><h3>Details</h3><p>The first run restarts once to enable WSL2. The company connect code is optional.</p>
268
+ <a class="button" href="/en/windows">Windows guide <svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></a></div>
269
+ </div>
270
+ </div>
271
+ </div>
231
272
  </div>
232
273
  </section>
233
274
 
234
- <section class="section">
235
- <h2 id="doc-groups">Three documentation groups</h2>
236
- <div class="split">
237
- <div class="card">
238
- <h3 id="get-started-group">Get started</h3>
239
- <p>For first-time users: installation, quickstart, and where the platform fits alongside other agent CLIs.</p>
240
- </div>
241
- <div class="card">
242
- <h3 id="build-group">Build</h3>
243
- <p>Daily operation: profiles, permissions, commands, workflows, and a dedicated MCP section for its broader command surface.</p>
275
+ <section class="home-section">
276
+ <div class="home-wrap">
277
+ <div class="home-head" data-reveal>
278
+ <p class="section-kicker">Changelog</p>
279
+ <h2 id="latest-updates">Steady releases, every change written down</h2>
280
+ <p>Each release says what changed and which Studio or Agent Watch it needs. <a href="/en/whats-new">See the full changelog</a>.</p>
244
281
  </div>
245
- <div class="card">
246
- <h3 id="operate-group">Operate</h3>
247
- <p>For operators and reviewers: security boundaries, repository architecture, terminal tools, and the team operating standard.</p>
282
+ <div class="updates">
283
+ <a class="update" href="/en/whats-new#v1-42-0" data-reveal>
284
+ <span class="update-meta"><span class="release-version">v1.42.0</span>Oct 25, 2026</span>
285
+ <h3>A redesigned dashboard and older messages that load without jumping</h3>
286
+ <p>The dashboard gets one design scale and every theme everywhere; older messages load as you scroll up and the message you are reading stays put.</p>
287
+ <span class="update-more">Read more <svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></span>
288
+ </a>
289
+ <a class="update" href="/en/whats-new#v1-41-0" data-reveal>
290
+ <span class="update-meta"><span class="release-version">v1.41.0</span>Oct 24, 2026</span>
291
+ <h3>Front-end change reports with before/after screenshots</h3>
292
+ <p>A new skill turns a front-end task into a report with framed before/after screenshots, business and logic changes and check results, shown in the dashboard.</p>
293
+ <span class="update-more">Read more <svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></span>
294
+ </a>
295
+ <a class="update" href="/en/whats-new#v1-40-0" data-reveal>
296
+ <span class="update-meta"><span class="release-version">v1.40.0</span>Oct 24, 2026</span>
297
+ <h3>Local projects are reported to Studio too</h3>
298
+ <p>Company conversations in folders without a remote report a local project to Studio, every run reports, and members see every kind of project warning.</p>
299
+ <span class="update-more">Read more <svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></span>
300
+ </a>
248
301
  </div>
249
302
  </div>
250
303
  </section>
251
- <nav class="pager" aria-label="Adjacent pages">
252
- <a class="pager-next" href="/en/ecosystem">
253
- <span class="pager-label">Next</span>
254
- <span class="pager-title">Ecosystem</span>
255
- </a>
256
- </nav>
257
304
 
258
- <footer class="footer">
259
- <p>Pi Agent Platform docs · static HTML · governed agent workflow</p>
260
- <div class="footer-links" aria-label="External links">
261
- <a href="https://piagent.io.vn" target="_blank" rel="noopener noreferrer">piagent.io.vn</a>
262
- <a href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer">GitHub repository</a>
263
- <a href="/" hreflang="vi">Tiếng Việt</a>
264
- <a href="https://www.facebook.com/vinhtam0544/" target="_blank" rel="noopener noreferrer">Facebook profile</a>
265
- </div>
266
- </footer>
267
- </div>
268
- </main>
269
-
270
- <aside class="toc" aria-label="Page contents">
271
- <p class="toc-title">On this page</p>
272
- <nav data-toc></nav>
273
- </aside>
305
+ <section class="home-wrap">
306
+ <div class="final-cta" data-reveal>
307
+ <h2>Hand work to the agent. Keep the decisions.</h2>
308
+ <p>Two commands to install. Docs in the order you need them.</p>
309
+ <div class="hero-cta" style="margin-top:0">
310
+ <a class="button primary lg" href="/en/quickstart">Install <svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-arrow-right"/></svg></a>
311
+ <a class="button lg" href="/en/ecosystem">Ecosystem</a>
312
+ <a class="button lg ghost" href="/en/benchmark"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-chart"/></svg> Benchmark</a>
313
+ </div>
314
+ </div>
315
+ </section>
316
+ </main>
317
+ <footer class="site-footer">
318
+ <div class="home-wrap">
319
+ <p>Pi Agent Platform · MIT · static docs, no cookies</p>
320
+ <nav aria-label="External links">
321
+ <a href="/en/quickstart">Docs</a>
322
+ <a href="/en/whats-new">Changelog</a>
323
+ <a href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer">GitHub</a>
324
+ <a href="https://www.npmjs.com/package/@piagent/platform" target="_blank" rel="noopener noreferrer">npm</a>
325
+ <a href="/" hreflang="vi">Tiếng Việt</a>
326
+ </nav>
327
+ </div>
328
+ </footer>
329
+ <div class="palette" data-palette data-index="/assets/search-en.json" data-empty="No page matches." role="dialog" aria-modal="true" aria-label="Search documentation">
330
+ <div class="palette-box">
331
+ <label class="palette-input"><svg class="icon" viewBox="0 0 24 24" aria-hidden="true"><use href="#icon-search"/></svg><input type="search" placeholder="Search the docs…" aria-label="Search documentation" autocomplete="off" spellcheck="false" /></label>
332
+ <div class="palette-results" data-results role="listbox"></div>
333
+ <div class="palette-foot"><span>↑↓ select</span><span>↵ open</span><span>esc close</span></div>
334
+ </div>
274
335
  </div>
275
336
  <script>
276
337
  window.va = window.va || function () { (window.vaq = window.vaq || []).push(arguments); };