Pi Agent Platform
v1.36.0 docs · VI Commands

Bản 1.9.0: nói việc bằng lời, Harness của team kiểm tra

Bỏ task contract và lệnh workflow. Chế độ công ty tự yêu cầu check và review; nút Dừng, lệnh có mạng theo lần duyệt và thẻ duyệt dễ đọc hơn.

v1.36.0 · 2026-10-21

Team memory học từ chỗ làm sai

Những gì memory đưa cho một lượt (brief, kết quả memory_search) được gửi lại Studio cùng lượt đó, để Studio chấm theo câu trả lời tiếp theo của member và thôi đưa những ghi chú member nói là sai (cần Agent Studio 0.37.0). Một lệnh lỗi giống nhau hai lần trong một lượt thành bài học; memory của repo bỏ qua task không thêm gì mới; skill hay làm hỏng lượt được đề xuất xem lại trong .pi/piagent-state/skill-proposals, Piagent không tự sửa skill.

v1.35.1 · 2026-10-21

Lỗi tạm thời của nhà cung cấp model không còn làm dừng task dài

Khi máy chủ của model (GPT, Claude) báo lỗi ngay giữa câu trả lời, Piagent hỏi lại sau vài giây; nếu cả vòng bị cắt, vòng sau tự bắt đầu sau một lúc chờ (tối đa 8 lần, khoảng 23 phút cho mỗi tin nhắn của bạn), agent được báo lý do và làm tiếp từ chỗ dở. Mỗi lần hỏi lại được ghi vào log trên máy.

v1.35.0 · 2026-10-21

Task dài chạy qua được lúc Studio cập nhật

Để task chạy qua đêm mà Studio cập nhật hay khởi động lại giữa chừng, Piagent không còn báo lỗi rồi dừng: nó chờ Studio trả lời lại rồi tự làm tiếp, không giới hạn thời gian chờ (Stop vẫn dừng được). Mỗi lần chờ được ghi vào log trên máy và báo về Studio (Logs → Mất kết nối) kèm nguyên nhân: Studio cập nhật, khởi động lại, hay mạng của máy. Một lượt trên dashboard giờ chạy được tới 24 giờ. Cần Studio 0.36.0.

v1.34.3 · 2026-10-20

Agent Watch báo cho cuộc trò chuyện công ty

Cuộc trò chuyện công ty ghi trạng thái vào chỗ Agent Watch không đọc, nên Agent Watch không báo khi nó chờ bạn hay đã xong. Giờ trạng thái được ghi vào thư mục Agent Watch đọc.

v1.34.2 · 2026-10-20

Kết quả của helper đến được Studio

Ở bản 1.34.1, kết quả của subagent bị Studio từ chối vì gửi bằng token đã hết hạn, nên Logs → Lượt agent không có gì. Giờ kết quả được gửi bằng token hiện tại của subagent và được ghi nhận.

v1.34.1 · 2026-10-20

Helper báo kết quả, Agent Watch báo khi cần bạn

Mỗi lần subagent chạy xong đều báo rõ kết quả: xong, lỗi, đã dừng hay chưa rõ (ví dụ verify không trả về kết luận), và Studio hiện kết quả đó trong Logs → Lượt agent. Khi giao việc cho subagent, agent có thể ghi rõ phạm vi, việc cần làm, ràng buộc, phần được phép đụng và bằng chứng cần có. Agent Watch (macOS 0.15.9, Windows 0.1.15) báo khi một cuộc trò chuyện đang chờ bạn duyệt, đang hỏi bạn, hoặc khi agent xong việc; file trạng thái chỉ có tên cuộc trò chuyện và tên project. Trong Source Changes, bạn bấm số dòng để comment trên diff rồi gửi tất cả cho agent thành một tin nhắn có đúng file và dòng; kết quả của subagent review hiện ngay dưới dòng nó nói tới. Piagent hỏi Studio những gì nó hỗ trợ trước khi dùng tính năng mới (cần Agent Studio 0.34).

v1.33.0 · 2026-10-20

Chạy trên Pi 1.3.0

Piagent chuyển từ Pi 0.87.1 lên Pi 1.3.0. Lời gọi tool có tham số JSON hỏng bị từ chối và trả lại cho model thay vì chạy với phần đọc được; lỗi gateway tạm thời được tự thử lại; cuộc trò chuyện mở lại giữ đúng các tool đang bật; Terminal báo trạng thái (đang làm, chờ bạn, xong, lỗi) cho terminal hỗ trợ OSC 7501. Lệnh pi cá nhân cũng lên 1.3.0. Sau khi cập nhật, Agent Watch đang chạy tự ghi lại binding. GPT-6.1 Sol trong cuộc trò chuyện công ty vẫn giữ cửa sổ 272k để chi phí không đổi.

v1.32.1 · 2026-10-19

Bypass được giữ sau khi tải lại, tab đang dùng không bị đăng xuất

Bật Bypass ngay sau khi agent trả lời có lúc bị Gateway từ chối vì cuộc trò chuyện vừa thay đổi, nên tải lại trang vẫn thấy “Hỏi trước”; giờ lệnh được gửi lại theo trạng thái mới nhất. Mở một cuộc trò chuyện khác cũng đang Bypass không còn hiện nhầm “Hỏi trước”. Phiên đăng nhập trên trình duyệt không còn hết hạn đúng 8 giờ sau khi mở khi tab vẫn đang dùng (lượt chạy hoặc treo lâu không còn bị đẩy ra màn hình hết phiên); chỉ tab bỏ không quá 8 giờ mới phải mở lại, và tối đa 7 ngày.

v1.32.0 · 2026-10-19

Lượt bị lỗi hoặc bấm Stop được dừng cả ở Studio

Khi một lượt trả lời lỗi giữa chừng hoặc member bấm Stop, Piagent báo Studio dừng lượt đó, để tài khoản của cuộc trò chuyện rảnh ngay cho lượt sau. Trước đây, qua Cloudflare, Studio có thể không biết kết nối đã đứt và tiếp tục stream tới 10 phút, khiến các lượt thử lại bị báo “tài khoản đang bận”. Cần Agent Studio 0.32.0.

v1.31.1 · 2026-10-19

memory_ask có ngay sau khi cập nhật

Cuộc trò chuyện công ty đầu tiên sau khi Studio lên 0.30.0 trước đây chưa có tool memory_ask. Giờ tool có mặt mỗi khi cuộc trò chuyện có memory của team; Studio cũ thì tool báo dùng memory_search.

v1.31.0 · 2026-10-19

Memory của team đi theo việc đang làm

Cùng Agent Studio 0.30.0: brief mở đầu bằng luật của team; memory của branch và thư mục đang làm được ưu tiên; điều agent nói “đã fix” là claim cho tới khi check pass (verified). Tool mới memory_ask trả lời câu hỏi từ memory của team, kèm nguồn. Thư mục chứa nhiều repo, repo không có remote origin và lỗi “dubious ownership” trên WSL không còn làm memory tắt im lặng.

v1.30.1 · 2026-10-18

Terminal công ty không còn hiện tên model; mở ở thư mục home báo đúng lý do

Header, thanh dưới và câu trả lời /model, /thinking của Terminal công ty chỉ còn vai trò và mức suy luận (Main agent (Rất cao) · Subagent review bật), không còn tên model của Harness. Cảnh báo “pi crashed… Run /bug” được viết lại vì /bug bị tắt trong cuộc trò chuyện công ty.

Chạy piagent studio ở thư mục home (~) trước đây báo managed-launch-binding-changed (“Agent Watch hoặc Piagent vừa cập nhật”) dù không có gì cập nhật. Piagent công ty không mở thư mục chứa cấu hình công ty, nên giờ nó báo đúng lý do và cách mở: vào thư mục dự án rồi chạy lại, hoặc piagent studio --project ~/dự-án.

v1.30.0 · 2026-10-18

Context lớn đi qua mạng chậm; Terminal công ty gọn như dashboard

Cuộc trò chuyện dài (context lớn tới khoảng 1 MB) gửi lên Studio được nén gzip khi Studio hỗ trợ (Agent Studio 0.28.2), nhỏ hơn khoảng 3 lần; cùng Studio 0.28.2, mạng chậm nhưng vẫn đang gửi không còn bị cắt sau 15 giây. Terminal công ty có dòng tóm tắt cuối lượt (request, token, thời gian, tốc độ), hiện Subagent đang chạy và branch git ở thanh dưới, thu gọn kết quả memory, ghi “Đang làm…”, chạy /bypass và /fast với một lần Enter, và báo đang kết nối Agent Watch lúc mở.

v1.29.0 · 2026-10-18

Terminal công ty có giao diện riêng; dừng lượt không còn làm hỏng cuộc trò chuyện

Terminal công ty (piagent studio) giờ có phần đầu riêng: team, model và mức suy luận theo Harness, quyền, Fast, memory. Thanh dưới hiện đúng mức suy luận, không hiện chi phí USD; plan hiện thành checklist; lúc chờ bạn trả lời câu hỏi thì ghi “Đang chờ bạn trả lời”. /share và /bug bị chặn vì gửi hội thoại công ty ra ngoài; /login, /model, /thinking… báo Harness của team quyết định. Dừng một lượt khi lệnh đang chạy không còn làm hỏng các lượt sau (cùng Agent Studio 0.28.1, Agent Watch 0.15.7).

v1.28.3 · 2026-10-18

Agent Watch tự cập nhật không còn làm gián đoạn Terminal công ty

Ngay sau khi Agent Watch tự cập nhật, piagent studio và dashboard chờ Watch ghi lại cấu hình (như sau khi Piagent cập nhật) thay vì báo managed-launch-binding-changed trong khoảng một phút; mọi mã băm vẫn được kiểm lại trước khi chạy.

v1.28.2 · 2026-10-18

Không còn lỗi “binding changed” ngay sau khi cập nhật

Ngay sau khi Piagent cập nhật, piagent studio không còn báo managed-launch-binding-changed trong lúc Agent Watch chưa ghi lại cấu hình: nó chờ tối đa 90 giây (“Agent Watch đang cập nhật cấu hình…”, hoặc báo Agent Watch không chạy), kiểm lại mọi mã băm rồi chạy tiếp. Member không phải nhập lại cấu hình bằng tay.

v1.28.1 · 2026-10-18

Terminal công ty và Pi cá nhân không còn giẫm chân nhau

Pi cá nhân không còn chết khi Piagent bị nạp hai lần (extension trỏ vào một bản Piagent khác): piagent-update và installer tự gỡ (có backup), piagent-doctor báo lỗi. Các mục công ty cũ của Agent Watch trong Pi cá nhân (provider agent_watch_*, model mặc định trỏ vào đó) được dọn khi máy đã dùng binding công ty. Pi cá nhân không tiếp tục cuộc trò chuyện công ty nữa và chỉ cách mở bằng piagent studio; Terminal công ty cũng hướng dẫn mở lại đúng cách, trả lời /help tại chỗ (không gửi model), và dừng hẳn khi bị dừng từ bên ngoài.

v1.28.0 · 2026-10-17

Team memory v2: ghi mỗi lượt đúng một lần, tóm tắt lại sau compaction

Với Agent Studio 0.28.0, mỗi lượt của cuộc trò chuyện công ty có mã riêng và được ghi vào outbox trước khi gửi, nên mất phản hồi, máy tắt ngang hay hai phiên cùng lúc cũng không làm memory rút kiến thức hai lần. Sau compaction, agent nhận lại bản tóm tắt mới cho yêu cầu gần nhất. Mỗi lượt kèm tối đa ba lần “check fail → sửa → pass” quan sát được (không đoán nguyên nhân). Bản tóm tắt rỗng không bị hỏi lại mỗi lượt, cuối lượt chờ tối đa 4,5 giây khi engine không trả lời, và trên Studio 0.27.x memory vẫn được ghi.

v1.27.1 · 2026-10-17

Team memory chạy ổn cả khi agent đang gọi model

Một lời gọi model làm mới token của run và huỷ token cũ, nên các commit gửi ngay sau bản tóm tắt và lệnh memory_search chạy cạnh một request bị Studio từ chối (401): commit của repo không vào được memory. Giờ lời gọi memory bị từ chối như vậy sẽ làm mới token (dùng chung với các request của role đó, như web search) rồi gửi lại một lần. Cần Agent Studio 0.27.1 (bản 0.27.0 đã rút lại).

v1.27.0 · 2026-10-17

Team memory: agent công ty nhớ những gì team đã chốt trong từng repo

Khi team bật memory trên Agent Studio 0.27.0, cuộc trò chuyện công ty mới mở đầu bằng một bản tóm tắt ngắn từ memory của team về repo (quyết định, quy tắc, việc đang làm, rút từ hội thoại và commit trước đó). Mỗi lượt được lưu lại cho team (đã lọc secret); agent và subagent tìm được trong memory bằng memory_search. Memory lỗi hay tắt không bao giờ làm hỏng hay chậm một lượt.

v1.26.1 · 2026-10-16

Đổi tên cuộc trò chuyện được cả khi lượt đang chạy

Đổi tên từ menu của cuộc trò chuyện trong lúc lượt đang chạy (nhất là cuộc trò chuyện công ty) từng hiện session-revision-stale và giữ tên cũ. Giờ tên mới được ghi ngay giữa lượt; nếu đổi tên, tạo nhánh hay lưu trữ vẫn không được, hộp thoại nói lý do bằng lời.

v1.26.0 · 2026-10-15

Lệnh / và phím tắt trên dashboard, /undo, dev server chạy qua nhiều lượt

Cuộc trò chuyện công ty làm việc như trong editor. Gõ / trên dashboard để dùng lệnh của Terminal (/name, /fork, /thinking, /bypass, /undo, /help…), lệnh chạy ngay trên dashboard và không gửi cho model; phím tắt ⌘⇧O chat mới, ⌘/ mở lệnh, Esc dừng lượt. /undo trả file mà lượt trước của agent đã sửa về như cũ, từng lượt một, và không đụng file bạn đã sửa sau đó. Agent giữ được dev server qua nhiều lượt (start_process), thấy ngay lỗi TypeScript của file vừa sửa, và piagent studio --prompt … --json xuất luồng sự kiện như pi --mode json.

v1.25.0 · 2026-10-13

Thiếu môi trường thì agent xin quyền, duyệt xong là chạy

Cuộc trò chuyện công ty không còn dừng ở “máy thiếu Java/Docker, em không làm được”. Máy thiếu runtime (JDK, Node đúng version…), cần tài khoản của bạn (git pull/push, registry riêng) hay cần ghi ra ngoài project, agent xin run_on_host: đúng một lệnh chạy trên máy bạn, ngoài sandbox, sau khi bạn duyệt (Bypass cũng hỏi). Docker đã cài mà chưa bật thì agent xin start_docker, chờ Docker chạy rồi làm tiếp ngay trong cuộc trò chuyện đó. Việc chỉ bạn làm được (mật khẩu sudo, trình cài, đăng nhập) thì agent hỏi kèm các bước và lựa chọn “Đã xong, làm tiếp / Bỏ qua”. fetch_origin fetch được repo nằm trong folder chứa nhiều repo, và lượt chỉ đọc bằng git -C không còn bị Harness coi là có sửa code.

v1.24.0 · 2026-10-13

Chọn Fast ngay khi tạo cuộc trò chuyện công ty

Khi Harness của team cho phép Fast, trang “Cuộc trò chuyện mới” có nút Fast: tắt / Fast: bật ngay cạnh model công ty. Bật trước khi gửi thì cuộc trò chuyện chạy Fast từ tin nhắn đầu tiên: main agent trả lời nhanh hơn trên model GPT (Codex), token tính vào quota gấp 2,5 lần, model và mức suy luận không đổi. Nút Fast ở đầu cuộc trò chuyện chuyển màu vàng khi đang bật để dễ nhận ra.

v1.23.1 · 2026-10-13

Câu hỏi của agent luôn nằm cuối cuộc trò chuyện

Câu hỏi và yêu cầu duyệt trước đây hiện phía trên lượt đang chạy, nên lượt chạy dài đẩy câu hỏi khỏi màn hình: mở một cuộc trò chuyện đang chờ bạn thì chỉ thấy activity. Giờ chúng luôn nằm cuối cuộc trò chuyện, ngay trên ô nhập, và trang tự cuộn tới khi có câu hỏi mới hoặc khi bạn mở cuộc trò chuyện đang chờ.

Thẻ câu hỏi dễ đọc hơn: chữ câu hỏi và đáp án lớn hơn, đáp án thoáng hơn, số của đáp án đang chọn được tô đậm. Ở giao diện sáng, nút “Để agent tự quyết” là nút viền thay vì nút đen nổi hơn cả “Gửi câu trả lời”.

v1.23.0 · 2026-10-13

Fast mode cho cuộc trò chuyện công ty, tool lỗi được báo về Studio

Khi Harness của team trong Agent Studio cho phép, dashboard có nút Fast ở đầu cuộc trò chuyện và Terminal có lệnh /fast on|off|status. Mỗi cuộc trò chuyện mới bắt đầu ở chế độ tắt. Khi bật, call của main agent trên model GPT (Codex) xin tier ưu tiên: cùng model và mức suy luận, trả lời nhanh hơn, và Studio tính token của call đó vào quota của key ở mức 2,5 lần. Subagent chạy như thường. Trên model Claude hay model của vendor dùng API key thì không thêm gì và lượt chạy ở tốc độ thường. Nếu Studio hay provider từ chối, call được gửi lại một lần ở tốc độ thường và cuộc trò chuyện quay về tốc độ thường kèm một ghi chú. Cần Studio 0.26.0 và Agent Watch có mang fast_mode của Harness.

Một tool chạy lỗi trong phiên công ty (Docker, lệnh mạng, test…) được báo về Agent Studio (Logs → “Tool lỗi”) để quản trị viên đọc được lý do: tool, mã lỗi, lệnh hoặc đường dẫn, phần đầu và cuối của output lỗi, hệ điều hành và máy có Docker engine hay không. Secret được che và thư mục home ghi là ~ trước khi gửi; không gửi prompt, câu tìm kiếm hay brief của subagent, và tool do bạn dừng hoặc từ chối thì không báo.

Sửa lỗi: sau khi quản trị viên đổi Harness (ví dụ main agent từ mức suy luận high sang max cố định), cuộc trò chuyện công ty mới tạo từ dashboard không gửi được tin nhắn đầu, chỉ hiện “Pi đã nhận yêu cầu và phiên đang đồng bộ lại”. Giờ cuộc trò chuyện mới bắt đầu ở mức mà Harness cho phép.

v1.22.1 · 2026-10-12

Dashboard không còn quay mãi khi project nằm trên ổ chậm

Sửa lỗi trên Windows: dashboard mở ra nhưng cứ hiện “Đang mở Piagent…”. Project nằm trên ổ Windows nhìn từ WSL (/mnt/d/…), nơi Git duyệt cây thư mục rất chậm. Phiên công ty chạy lượt quét đó mà không có giới hạn nên không trả lời ai trong lúc ấy, và dashboard chờ nó, cũng không có giới hạn. Giờ dashboard chờ phiên công ty tối đa 15 giây cho mỗi lượt đọc; quá hạn thì vẫn mở với các cuộc trò chuyện cá nhân, ghi rõ “Phiên công ty đang chạy nhưng không trả lời” kèm cách xử lý, và một phút sau hỏi lại.

Trang của một cuộc trò chuyện cho Git 8 giây mỗi repository để liệt kê file thay đổi. Repository nào lâu hơn thì hiện chưa có danh sách file thay đổi và được thử lại sau 5 phút. Trên Windows, nên để project trong ổ của Ubuntu (~/projects): project ở /mnt/c hay /mnt/d vẫn dùng được nhưng chậm.

v1.22.0 · 2026-10-09

Đính kèm được mọi file code và văn bản, như các coding agent khác

Giờ bạn đính kèm được .html, .css, .js/.ts/.tsx, .py, .go, .java, .sql, .xml, .svg, .toml và bất kỳ đuôi nào khác, cả file không có đuôi như Dockerfile, Makefile. File được gửi dưới đúng tên của nó nên agent biết đó là HTML hay Python; Piagent vẫn kiểm tra nội dung đúng là văn bản. File nhị phân bị từ chối ngay kèm cách gửi khác: bảng tính thì xuất sang .csv, file trình chiếu thì .pdf, file nén, video, font thì để trong project cho agent tự đọc bằng tool.

Sửa lỗi: tin nhắn có file đính kèm không còn hiện hai lần (một lần kèm nguyên nội dung file) sau khi lượt xong; chỉ còn câu bạn gõ và thẻ file.

v1.21.1 · 2026-10-09

Bật Bypass ngay cả khi lượt đang chạy, và Bypass được giữ

Sửa lỗi: bật Bypass lúc một lệnh đang chờ bạn duyệt không có tác dụng. Gateway từ chối đổi quyền khi lượt đang chạy, còn thông báo lỗi lại nằm trong bảng vừa đóng, nên trông như đã bật nhưng tải lại trang thì vẫn là “Hỏi trước”. Giờ cuộc trò chuyện công ty đổi giữa “Hỏi trước” và Bypass lúc nào cũng được, kể cả giữa lượt; quyền được đọc lại ở mỗi lệnh nên các lệnh sau làm theo lựa chọn mới. Lệnh đang chờ vẫn giữ thẻ duyệt (Cho phép hoặc Từ chối). Kết quả đổi quyền hiện thành thông báo ở trên cùng.

v1.21.0 · 2026-10-09

Việc cần bạn quyết hiện từng cái một, và biết ngay cuộc trò chuyện nào xong hay đang chờ bạn

Câu hỏi và yêu cầu duyệt của agent không còn xếp chồng dài xuống trang: mỗi lần chỉ hiện một thẻ, phía trên có thanh “Việc cần bạn quyết · 1/3” ghi rõ ai hỏi (main agent hay subagent nào), loại việc (Hỏi / Duyệt) và cho bấm chuyển sang việc khác. Việc của main agent hiện trước vì câu trả lời của bạn định hướng việc của subagent; sau đó tới subagent theo thứ tự làm việc (scout, research, verify, review); trong cùng một agent, việc hỏi trước hiện trước. Trả lời xong thẻ này thì thẻ kế tiếp hiện lên.

Làm nhiều cuộc trò chuyện cùng lúc: góc phải trên màn hình hiện thông báo khi một cuộc trò chuyện khác xong lượt, bị lỗi, bị dừng, hoặc đang chờ bạn trả lời hay duyệt; bấm “Mở” để vào đúng cuộc trò chuyện đó. Thông báo “Xong” tự ẩn sau vài giây, việc đang chờ bạn thì giữ đến khi bạn trả lời hoặc mở. Ở cột trái, cuộc trò chuyện đang chờ bạn sáng viền cam và ghi “Cần bạn trả lời” hoặc “Cần duyệt”, cuộc trò chuyện xong khi bạn đang ở chỗ khác ghi “Xong · chưa xem” cho đến khi bạn mở, và cả hai được đưa lên đầu mục “Đang chạy · cần chú ý”. Tiêu đề tab đếm số việc đang chờ, ví dụ “(2) Piagent”.

Studio ghi lại mỗi lần cuộc trò chuyện công ty được thu gọn (compact): lý do, kích thước trước và sau, kết quả, hiện trong Logs → Lượt agent (cần Agent Studio 0.25.0).

v1.20.0 · 2026-10-09

Cài package trong sandbox công ty không phải duyệt nữa

Lệnh bash thường tải được từ các registry quen thuộc: npm, PyPI, Go proxy, crates.io, Maven Central, Gradle, NuGet, RubyGems, Packagist, pub.dev, CocoaPods, Hex, và tải về public từ GitHub (ví dụ bản Gradle mà ./gradlew cần). Nhờ vậy npm install, pip install, go mod download, ./mvnw test hay ./gradlew test chạy ngay, không phải chờ bạn duyệt. Piagent đi qua một proxy chạy ngoài sandbox: chỉ các host đó, cổng 443 và 80, không bao giờ tới IP trực tiếp, máy của bạn hay mạng nội bộ. Host khác bị chặn, lỗi ghi rõ host nào, và lệnh cần host đó vẫn phải qua run_with_network để bạn duyệt. Muốn thêm registry riêng của công ty, ghi tên host (hoặc *.domain) vào ~/.piagent/sandbox-domains, mỗi dòng một host. Thông tin đăng nhập registry và git vẫn không vào sandbox, nên không push hay publish được.

Ở chế độ Bypass, run_with_docker chạy luôn không cần duyệt, giống run_with_network; chỉ push, deploy, đăng nhập registry hay lệnh xoá không rõ đích là vẫn hỏi.

Sửa lỗi: subagent chạy lâu hơn 15 phút (ví dụ verify chạy cả bộ test trong lúc main agent chờ) không còn bị dừng với managed-helper-cancelled nữa. Nhờ subagent review xem lại code đã commit ở các lượt trước thì nó không còn báo “không có patch”. Review đọc các commit kể từ commit, nhánh hoặc HEAD~N mà agent chỉ ra; nếu lượt hiện tại chưa sửa gì, nó đọc các commit của nhánh kể từ lúc tách khỏi nhánh chính.

v1.19.0 · 2026-10-08

Task có checklist được làm đến hết, và mỗi lượt báo rõ đã xong hay chưa

Trong cuộc trò chuyện công ty, khi main agent tự dừng lúc checklist còn bước (ví dụ làm xong STEP06 rồi dừng, dù bạn giao đến STEP22) và Harness của team bắt buộc plan, Harness tự cho agent làm tiếp bước kế tiếp, như bạn gửi “tiếp tục”. Nó dừng khi checklist xong, khi bạn bấm Stop hoặc nhắn tin, khi gặp lỗi, hoặc sau 2 vòng liên tiếp không xong thêm bước nào. Cuối mỗi lượt có một dòng: Hoàn thành, Dừng giữa chừng còn x/y bước (kèm lý do), Lượt dừng vì lỗi, hoặc Bạn đã dừng lượt này, với nút Tiếp tục khi task chưa xong; danh sách cuộc trò chuyện cũng hiện trạng thái này. Bước bạn bảo để sau được đánh dấu “để sau”, không bao giờ bị ghi là xong; gửi “tiếp tục” là agent nhận lại checklist đang dở. Lượt mà agent đã commit vẫn được chạy check và review.

Sandbox công ty dùng được Docker: khi máy đang chạy Docker (Docker Desktop, Colima, OrbStack…), agent có run_with_docker để chạy một lệnh bạn duyệt với internet và Docker, ví dụ bật database cho test bằng docker compose up -d, docker build hay test Testcontainers. Docker không mang theo thông tin đăng nhập registry; Bypass vẫn hỏi khi lệnh hoặc file compose mount thư mục ngoài project. ./gradlew và ./mvnw dùng lại bản Gradle/Maven đã có trên máy nên không phải xin mạng. Folder chứa nhiều repo (FE, BE… mỗi folder một git) hiện “N repo”: bấm vào để xem từng repo, nhánh và số file thay đổi, rồi đổi nhánh trong repo đó; danh sách folder đầy thì tự bỏ folder đã mất hoặc lâu nhất, không còn báo “Không thể thêm thư mục”.

v1.18.0 · 2026-10-08

Đổi nhánh Git trên dashboard, tự thử lại khi lỗi tạm thời, Claude Haiku 5.5

Bấm vào tên nhánh dưới tên cuộc trò chuyện hoặc ở thanh trạng thái để chọn nhánh khác hoặc tạo nhánh mới. Dashboard không cho đổi khi còn cuộc trò chuyện đang chạy trong folder, và báo đúng lý do khi Git từ chối (ví dụ thay đổi chưa commit sẽ bị ghi đè). Khi câu trả lời của model hỏng vì lý do tạm thời (stream bị cắt, model hoặc gateway của Studio không trả lời), Piagent tự hỏi lại tối đa 2 lần trước khi báo lỗi; lỗi quota, key hay chính sách vẫn báo ngay. Claude Haiku 5.5, model nhanh nhất của Anthropic, có thể chọn ở chế độ công ty và cá nhân.

v1.17.0 · 2026-10-08

Dashboard hiện nhánh Git của project

Dưới tên cuộc trò chuyện, ở thanh trạng thái và cạnh từng nhóm project trong sidebar, dashboard hiện project đang đứng ở nhánh Git nào, kể cả worktree. Khi Git không ở nhánh nào (detached HEAD), dashboard hiện mã commit ngắn bằng màu cảnh báo. Đổi nhánh trong Terminal thì dashboard cập nhật khi bạn quay lại tab.

v1.16.3 · 2026-10-08

Dashboard cập nhật xong vẫn tự kiểm tra bản mới

Trước đây, cập nhật bằng nút trên dashboard sẽ khởi động lại dashboard với việc kiểm tra bản mới bị tắt, nên dashboard không báo bản kế tiếp cho tới khi khởi động lại máy. Bản này sửa lỗi đó, kể cả khi cập nhật lên 1.16.3 từ bản cũ.

v1.16.2 · 2026-10-08

Terminal nói giống dashboard

Có bản Piagent mới thì Terminal (pi và piagent studio) hỏi Cập nhật ngay hoặc Để sau (nhắc lại sau 1 giờ), chỉ giữa các lượt, kèm một dòng dưới footer; /piagent-update kiểm tra ngay.

  • /bypass trong piagent studio bật/tắt Bypass cho cuộc trò chuyện, giống công tắc trên dashboard; footer hiện "Bypass" khi đang bật.
  • Lệnh cần internet được hỏi kèm lý do, lý do Bypass vẫn hỏi và hậu quả khi đồng ý hay từ chối.
  • Lỗi khi gửi, lỗi khi mở phiên công ty và ghi chú của Harness (check, review, phản biện của subagent, "bạn quyết định") hiện bằng tiếng Việt như trên dashboard.
  • Với Agent Watch 0.15.2: sau khi Watch cập nhật mà cần cấp lại quyền Keychain, Watch hỏi bằng dialog và cập nhật lại cấu hình Piagent ngay.

Bản này đổi trình khởi chạy công ty: Agent Watch tự cập nhật cấu hình ở lần đồng bộ kế tiếp (vài phút). Nếu piagent studio báo cấu hình đã đổi, mở Agent Watch → Studio và nhập lại cấu hình cho Piagent.

v1.16.1 · 2026-10-07

Báo bản mới rõ ràng, kiểm tra mỗi giờ

Khi có bản Piagent mới, dashboard mở một dialog ghi rõ sẽ đổi gì và nút Cập nhật ngay; chọn Để sau thì 1 giờ sau nhắc lại. Cập nhật xong, dashboard mở lại báo đã thành công. Dashboard và Terminal tự kiểm tra bản mới mỗi giờ.

  • Tab dashboard không còn bị mất đăng nhập khi một server Piagent khác trên máy (runtime công ty, lần mở khác) đăng nhập.
  • Tab đã hết phiên (Piagent khởi động lại, quá 8 giờ) không còn gọi lại liên tục với lỗi 401 mà nói rõ cách mở lại: piagent dashboard hoặc Agent Watch.

Cập nhật từ 1.16.0 không cần nhập lại cấu hình trong Agent Watch.

v1.16.0 · 2026-10-07

Bypass cho cuộc trò chuyện công ty

Chọn Bypass trong tùy chọn cuộc trò chuyện mới hoặc trên thanh đầu cuộc trò chuyện ("Hỏi trước" vẫn là mặc định). Lệnh cần internet (cài package, tải file, git pull, test có server hay browser) chạy luôn, không hỏi. Vẫn hỏi trước khi đẩy hoặc gửi dữ liệu ra ngoài (git push, publish, deploy, upload, ssh), chạy migration database, xóa mà không rõ đích hoặc dùng sudo.

  • Harness công ty thêm subagent trong lúc bạn đang làm: dùng được ngay từ tin nhắn kế tiếp, không cần mở cuộc trò chuyện mới. Với Studio 0.20.1, lượt đang chạy không bị dừng khi Harness được lưu.
  • Phiên cá nhân "Toàn quyền" không còn hỏi trước git add toàn bộ; xóa, migration và thao tác ra ngoài vẫn hỏi.

Cập nhật từ 1.15.x không cần nhập lại cấu hình trong Agent Watch.

v1.15.2 · 2026-10-07

Cuộc trò chuyện công ty dài tự thu gọn trở lại, và sớm hơn

Tóm tắt hội thoại dài ở chế độ công ty gửi nhầm key giữ chỗ thay vì quyền của lượt chạy, nên Studio từ chối (401 authentication_required, hiện là "Chưa chọn tài khoản" / "CLI trực tiếp" trong theo dõi request) trước mỗi bước và hội thoại cứ dài thêm. Giờ tóm tắt dùng quyền của lượt chạy và Studio ghi là summary.

  • Hội thoại được tóm tắt khi đạt 90% cửa sổ của model và muộn nhất ở 300k token: 244,8k với GPT 272k (giá gấp đôi trên 272k), 300k với model 1M thay vì khoảng 984k. Khoảng 20k token gần nhất vẫn giữ nguyên văn.
  • Tóm tắt bị lỗi được thử lại sau 1, 2, 4 … phút (tối đa 30) thay vì trước mỗi bước.

Cập nhật từ 1.15.x không cần nhập lại cấu hình trong Agent Watch.

v1.15.1 · 2026-10-07

Studio thấy mỗi call của model dùng để làm gì

Mỗi call model trong phiên công ty báo cho Studio nó dùng để làm gì: trả lời tin nhắn, bước tiếp sau tool (kèm tên tool vừa chạy), lượt harness yêu cầu, tóm tắt hội thoại, subagent nhận việc (kèm tiêu đề một dòng của việc) hoặc tìm web. Không gửi thêm nội dung prompt nào khác. Studio 0.20.0 hiện chúng ở Logs → "Lượt agent".

  • Nhiều cuộc trò chuyện công ty trong cùng một folder không còn nhận nhầm thay đổi của nhau: check, review và kế hoạch chỉ xét các file chính cuộc trò chuyện đó đã sửa.
  • Cuộc trò chuyện công ty mới không mở được runtime nói rõ lý do, và Lưu trữ hoặc Khởi động lại dùng được mà không cần khởi động lại dashboard.
  • mvnw/gradlew tải bị chặn được chỉ sang run_with_network; piagent doctor chạy piagent-doctor.

Cập nhật từ 1.14.x hoặc 1.15.0 không cần nhập lại cấu hình trong Agent Watch.

v1.15.0 · 2026-10-07

Subagent bị từ chối nói đúng lý do

Khi Studio từ chối một subagent công ty, Piagent nay báo lý do của Studio thay vì luôn báo "cấu hình vừa thay đổi". Ví dụ: không tài khoản AI nào của công ty phục vụ model của vai trò này, và quản trị viên cần gắn hoặc bật một tài khoản. Cần Agent Watch 0.15.0; với Studio 0.19.0, subagent thiếu tài khoản lúc bắt đầu lượt sẽ tự lấy model đang phục vụ khi được gọi.

  • Lệnh in nhiều và chạy lâu (bộ test, build) không còn bị dừng với managed-tool-output-too-large.
  • Lệnh ghi vào /tmp ở chế độ công ty được chỉ sang $TMPDIR hoặc thư mục project.
  • piagent-update chạy từ npm exec cài helper lâu dài; trên Windows, Pi được tìm thấy trong npm prefix tùy chỉnh.

Cập nhật từ 1.14.x không cần nhập lại cấu hình trong Agent Watch.

v1.14.0 · 2026-10-06

Cập nhật giữ lựa chọn model của bạn

piagent-update, nút cập nhật trong dashboard và piagent-setup chỉ đặt default model và danh sách model của Pi ở lần cài đầu. Từ bản này, mỗi lần cập nhật giữ nguyên model bạn đã chọn và danh sách của bạn, chỉ thêm model bản mới lần đầu đưa vào; model bạn đã bỏ ra không bị thêm lại. Muốn áp lại preset của Piagent: piagent-update -- --reset-model-scope.

  • Trên Windows (WSL2), cập nhật không còn báo WSL2 là thử nghiệm: đó là cách Piagent chạy trên Windows từ 1.13.0.
  • Windows cài bằng một lệnh PowerShell: xem trang Cài trên Windows.

Cập nhật từ 1.13.x không cần nhập lại cấu hình trong Agent Watch.

v1.13.1 · 2026-10-06

Cuộc trò chuyện giữ chỗ đang đọc, chữ của agent có định dạng

Mở lại một cuộc trò chuyện không còn nhảy về tin đầu tiên: mỗi cuộc giữ đúng chỗ đang đọc, cuộc mở lần đầu hoặc đang đọc tới cuối thì mở ở tin mới nhất và theo câu trả lời đang chạy. Chữ agent viết giữa các tool call hiển thị có định dạng như câu trả lời, không còn lộ markdown thô. Cập nhật từ 1.13.0 không cần import lại trong Agent Watch.

v1.13.0 · 2026-10-06

Piagent trên Windows qua WSL2

Thành viên dùng Windows chạy Piagent trong WSL2 (Ubuntu), cả cuộc trò chuyện công ty lẫn cá nhân. Cuộc trò chuyện công ty có sandbox bubblewrap giữ đúng những gì sandbox macOS bảo đảm, và Agent Watch cho Windows giữ key công ty. Hướng dẫn cài đặt: Piagent trên Windows.

  • Project, cache package của project và thư mục tạm riêng ghi được; folder khác trong home chỉ đọc để tham chiếu; mục ẩn trong home không có trong sandbox; file credential đọc ra rỗng.
  • Lệnh chưa được duyệt mạng chỉ tới được server do chính nó mở; tiến trình lệnh để lại kết thúc cùng lệnh.
  • Từ WSL, hộp chọn folder là hộp thoại của Windows và link mở trong trình duyệt Windows.
  • Chạy thẳng trên Windows là bản xem trước cho chế độ cá nhân; piagent-update chưa chạy ở đó.

Sau khi cập nhật, mỗi thành viên nhập lại cấu hình Piagent trong Agent Watch (macOS: Studio → Áp dụng cho Piagent; Windows: Kết nối Piagent trong WSL).

v1.12.1 · 2026-10-06

Nhánh cuộc trò chuyện công ty gửi được tin nhắn

Tạo nhánh (fork) một cuộc trò chuyện công ty để giữ context giờ gửi tin nhắn bình thường. Trước đây nhánh vẫn hiện trong danh sách nhưng mọi tin nhắn đều báo “Tin nhắn chưa được gửi”. Nhánh tạo bằng bản cũ cần tạo lại sau khi cập nhật.

v1.12.0 · 2026-10-06

@ tới mọi folder, skill dùng bằng /, và test chạy được trong sandbox công ty

Chỉ cho agent đúng file hay folder cần đọc, dùng lại skill và command đã có, và để agent tự chạy unit test lẫn integration test của project.

@ file và folder

Gõ @ trong khung chat để chọn file, folder của project; gõ ~/ hoặc / để chọn folder khác trên máy. Agent đọc được folder ngoài project, chỉ đọc; file ẩn trong home, ~/Library và file chứa credential vẫn bị chặn.

Giữ tin nhắn đang soạn

Tin nhắn gõ dở ở mỗi cuộc trò chuyện và ở khung chat mới vẫn còn khi chuyển sang cuộc trò chuyện khác hay tải lại trang, cùng file đã đính kèm.

Skill và command

Skill và command trong .claude, .codex, .agents và .pi của project và trên máy dùng được ngay: model thấy danh sách skill, gõ / ở đầu tin nhắn để chọn /command hoặc /skill:tên.

Test trong sandbox công ty

Cache package giữ theo project (npm, pnpm, pip, uv, Go, Cargo, Gradle, Maven, NuGet…), server và database trên localhost, Xcode đã chọn, JDK, .NET. Chạy piagent studio --doctor để xem ngôn ngữ nào sẵn sàng. Docker và iOS Simulator chưa dùng được trong sandbox.

v1.11.1 · 2026-10-05

Cập nhật xong là dashboard chạy bản mới

Bấm cập nhật trong dashboard hay chạy piagent-update, dashboard đều mở lại trên bản vừa cài, không còn giữ giao diện của bản cũ.

Khởi động lại sau khi cập nhật

Nút cập nhật cài bản mới rồi khởi động lại dashboard và mở trong tab mới. Ở 1.11.0, bước khởi động lại không chạy được trên bản cài từ npm.

Thay dashboard của bản cũ

Sau piagent-update, lệnh piagent dashboard dừng dashboard của bản cũ còn đang chạy và mở dashboard của bản mới.

v1.11.0 · 2026-10-05

Cập nhật bằng một nút, và dashboard như một trình soạn code

Dashboard tự kiểm tra bản mới và cập nhật Pi cùng Piagent khi bạn bấm. Thanh trạng thái, bảng lệnh và Cài đặt có ô tìm kiếm giúp mọi thao tác đều nằm trong tầm phím.

Cập nhật một nút

Dashboard kiểm tra khi mở và mỗi 6 giờ. Có bản mới thì thanh trạng thái báo "Cập nhật Piagent"; bấm là Pi và Piagent được cài cùng nhau rồi dashboard mở lại trong tab mới. Pi luôn lên đúng bản Piagent đã kiểm chứng, và nút bị khoá khi đang có lượt chạy.

Bảng lệnh

⌘K hoặc Ctrl+K mở mọi thao tác, mọi mục cài đặt và mọi cuộc trò chuyện theo tên; gõ không dấu vẫn tìm được. ⌘, hoặc Ctrl+, mở Cài đặt.

Ô tìm kiếm tìm cài đặt theo việc nó làm, các mục được chia nhóm, có mục Cập nhật và Phím tắt. Thanh trạng thái dưới đáy cho biết Gateway, số lượt đang chạy và phiên bản.

v1.10.0 · 2026-10-05

Main agent hỏi lại khi chưa rõ, subagent được phản biện brief

Khi yêu cầu còn để ngỏ một quyết định, main agent hỏi bạn bằng thẻ câu hỏi có lựa chọn đánh số thay vì đoán. Subagent được nêu bằng chứng khi brief lệch yêu cầu, và bất đồng lần hai thì bạn quyết. Hết quota hay patch quá lớn không còn làm dừng việc.

Hỏi lại bằng lựa chọn

1–4 câu hỏi, mỗi câu 2–4 lựa chọn đánh số, luôn có "Khác" để tự nhập và "Để agent tự quyết". Bấm số để chọn, Enter để gửi. Bấm Dừng giữa chừng thì khi "tiếp tục", agent hỏi lại chứ không chọn thay bạn.

Subagent phản biện brief

Subagent đọc nguyên văn yêu cầu và plan trước brief. Brief sai hoặc lệch yêu cầu thì subagent nêu bằng chứng và main agent phải trả lời. Bất đồng lần hai, hội thoại ghi "Cần bạn quyết".

Chạy tiếp khi hết quota

Subagent hết quota hoặc tài khoản đang nghỉ sẽ chạy lại trên model dự phòng của Harness. Patch trên 120 KB được review theo từng phần rồi gộp findings.

v1.9.3 · 2026-10-03

Gõ tiếng Việt không gửi nhầm, subagent đọc trang gọn hơn

Phím Enter dùng để chốt chữ khi gõ dấu chỉ chốt chữ, không gửi tin. Bấm Enter hai lần liên tiếp cũng chỉ tạo một cuộc trò chuyện và gửi một tin. Subagent đọc mỗi trang web ít hơn, nên một câu hỏi tin tức tốn ít token hơn hẳn.

Enter khi gõ dấu

Với bộ gõ Telex, VNI hay các bộ gõ khác, Enter dùng để chốt chữ không còn gửi tin hay tạo cuộc trò chuyện. Shift+Enter vẫn xuống dòng.

Gửi đúng một lần

Bấm Enter hai lần, hoặc Enter rồi bấm nút gửi, trước khi trang kịp cập nhật vẫn chỉ tạo một cuộc trò chuyện và gửi một tin.

Subagent đọc trang gọn hơn

Subagent đọc tối đa 20.000 ký tự mỗi trang, mặc định 12.000. Main agent vẫn đọc được tới 100.000 ký tự.

v1.9.2 · 2026-10-03

Việc trên web để subagent nghiên cứu làm, khung chat không giật

Ở chế độ công ty có subagent nghiên cứu, mọi việc trên web do subagent này làm trên model rẻ hơn. Main agent chỉ nhận bản tóm tắt kèm nguồn. Gửi tin nhắn trong cuộc trò chuyện dài không còn kéo trang lên đầu.

Web cho subagent nghiên cứu

Khi Harness có subagent nghiên cứu, main agent không còn công cụ web. Search và đọc trang chạy trên model của subagent nghiên cứu.

Biết engine nào đã search

Mỗi kết quả search ghi rõ engine đã trả lời: Tavily, Exa hay Parallel qua search pool của công ty, hoặc search riêng của nhà cung cấp model.

Khung chat đứng yên

Gửi tin nhắn không còn làm lịch sử biến mất trong chốc lát và kéo trang lên đầu. Thanh trên hiện đúng số subagent mà Harness bật.

v1.9.1 · 2026-10-03

Subagent khảo sát và xác minh, tìm web cho mọi vai

Ở chế độ công ty, Harness của team bật thêm được hai subagent chạy model rẻ. Subagent khảo sát đọc code trước khi sửa. Subagent xác minh chạy lại check và đối chiếu kết luận với bằng chứng. Mọi vai, kể cả vai chạy model API key, tìm web qua search pool của team.

Subagent khảo sát

Chỉ đọc project, không lên web và không chạy lệnh. Kết quả trả về kèm file và dòng. Agent chính giao phần đọc rộng cho nó để giữ context cho việc sửa.

Subagent xác minh

Chạy check của repo trong sandbox chỉ-đọc, không có mạng, và đối chiếu từng yêu cầu với code và nguồn gốc. Mỗi yêu cầu được trả lời là đạt, không đạt hoặc không kiểm được, kèm bằng chứng. Check nó chạy qua được tính vào quy trình của lượt.

Tìm web qua search pool

web_search hỏi search pool của Studio trước: key tìm kiếm của team, rồi tới nguồn không cần key. Nhờ vậy vai chạy model API key cũng tìm được web.

Chỉ subagent được bật

Agent chính chỉ thấy các subagent mà Harness bật. Dashboard hiện số subagent đang chạy trên số được bật.

Sandbox chạy được test của project

Sandbox đọc được file dịch tên auth.json và giấu hẳn file .env* (trừ file mẫu), nên type-check, Vitest và Next chạy được mà không lộ secret. E2E bằng Chromium của Playwright chạy qua lệnh có mạng mà bạn duyệt.

Bộ cài gọn hơn

piagent-install và piagent-setup không còn gợi ý lệnh đã bỏ ở 1.9.0. Chúng chỉ nhắc /mcp và /subagents-doctor khi lần cài đó có cài chúng.

Đã chạy thật một lượt ở chế độ công ty qua Studio. Subagent khảo sát đọc repo trước khi sửa, subagent xác minh báo 6/6 yêu cầu đạt, review không có lỗi chặn, và mọi request đều được tính usage.

v1.9.0 · 2026-10-02

Nói việc bằng lời, Harness của team lo phần kiểm tra

Bỏ task contract và các lệnh workflow: bạn giao việc như nói với đồng nghiệp, guard vẫn kiểm tra từng tool call. Chế độ công ty chạy qua Agent Studio và Agent Watch; Harness tự yêu cầu chạy check, cho subagent review và gửi lỗi chặn lại cho agent sửa. Xem Hệ sinh thái.

Kịch bản chạy thật13/139 cá nhân, 4 chế độ công ty, trên bản cài cuối
Test tự động5.800+unit, integration và security; 0 lỗi
Test trình duyệt27/27dashboard và WebUI trên Chromium
Guard gọn hơn−854 dòngcode chỉ phục vụ task contract (4993 → 4139)
Một lượt ở chế độ công ty: agent sửa code và chạy test, kết quả Check đã qua và Review không có lỗi chặn ghi dưới câu trả lời
Một lượt ở chế độ công ty: agent sửa code và chạy test, một subagent review bản sửa, kết quả ghi ngay dưới câu trả lời.

Giao việc bằng lời thường

Không còn /workflow, /fresh, /onboard hay task contract. Guard vẫn chặn file bảo vệ, kiểm profile quyền, file quá lớn, sửa trên bản đã cũ, và hỏi bạn trước push hay publish.

Harness của team

Studio quyết định mỗi lượt cần kế hoạch, check và review ở mức gợi ý hay bắt buộc. Review do một subagent riêng làm; lỗi chặn được gửi lại cho agent trong số vòng sửa team đặt.

Mạng theo lần duyệt

Lệnh ở chế độ công ty chạy không mạng. Khi cần cài package, agent xin chạy đúng một lệnh có mạng; thẻ duyệt ghi rõ câu lệnh và bạn cho phép một lần.

Dừng và tiếp tục

Nút Dừng có hiệu lực suốt lượt, kể cả lúc review đang chạy. Lượt bị dừng ghi rõ là đã dừng, không báo lỗi model; bấm Tiếp tục để làm tiếp từ các bước đã giữ.

Kết nối lại chế độ công ty

Nếu phần chạy của công ty đang tắt (máy vừa khởi động, vừa cập nhật), cuộc trò chuyện báo rõ và có nút Kết nối lại ngay tại chỗ.

Không lẫn vào git

Thư mục .pi/piagent-state tự có .gitignore; trạng thái chạy không còn hiện trong git status của project.

Xếp hàng khi công ty bận

Khi mọi tài khoản model của công ty đang bận, yêu cầu tự chờ tới lượt (tối đa 20 phút) thay vì báo lỗi. Lượt đang chạy hiện bước “Chờ tài khoản công ty rảnh”; nút Dừng vẫn dùng được.

Nhiều cuộc trò chuyện cùng lúc

Tạo hay gửi trong một cuộc trò chuyện không còn bị từ chối chỉ vì cuộc khác vừa đổi. Hai thư mục trùng tên (hai bản clone) hiện thêm vị trí để chọn đúng.

Dọn model không còn

piagent-doctor chỉ ra model đã cấu hình mà Pi không còn biết; piagent-model-scope --prune chỉ xoá đúng các dòng đó.

Ảnh từ dashboard

Những gì thành viên thấy khi làm việc

Thẻ duyệt một lệnh có mạng, ghi đúng câu lệnh npm install sẽ chạy
Duyệt một lệnh có mạng: thẻ ghi đúng câu lệnh và điều xảy ra khi cho phép hay từ chối.
Chọn model khi mở cuộc trò chuyện mới: nhóm Công ty và nhóm Cá nhân
Cuộc trò chuyện mới: chọn model của công ty hoặc model cá nhân trong cùng một dashboard.
Đang review: thanh trên ghi Subagent 1/2 và nút Dừng vẫn còn
Review đang chạy: thanh trên ghi Subagent 1/2, nút Dừng vẫn hoạt động.
Một lượt cá nhân sửa code, diff hiện ngay trong thẻ Sửa
Chế độ cá nhân: mỗi bước đọc, sửa, chạy lệnh là một thẻ; diff mở ngay tại chỗ.

Kiểm chứng

Chạy thật như một thành viên

Mỗi kịch bản do script điều khiển trình duyệt thật trên bản đã cài, gửi tin nhắn như người dùng rồi kiểm tra kết quả trên đĩa. Lỗi trải nghiệm tìm thấy được sửa kèm test rồi chạy lại.

Kịch bảnKết quả
Công ty · bỏ dấu tiếng Việt cho slug, thêm test2 file đổi, test qua, "Check đã qua trên code cuối · Review không có lỗi chặn"
Công ty · bấm Dừng lúc review đang chạy"Lượt bị dừng trước khi kiểm chứng xong", không báo lỗi
Công ty · cài package cần mạngThẻ duyệt ghi đúng lệnh; sau khi cho phép, package có trong package.json
Công ty · nhắn thêm lúc lượt đang chạyTin được giữ, gửi khi lượt xong và được trả lời
Cá nhân · sửa code, chạy test, commit và pushPush chờ duyệt trên trình duyệt; dừng lệnh dài không để lại tiến trình
Cá nhân · đọc .envBị chặn, không lộ giá trị; agent chỉ cách tự mở

Kết quả benchmark và journey của các bản trước được đo khi còn task contract; chúng là số liệu lịch sử, bản 1.9.0 chưa đo lại.

Các bản trước

Phần dưới là ghi chú của các bản cũ, đúng với thời điểm phát hành. Từ bản 1.9.0, task contract, trajectory, completion receipt và các lệnh workflow nhắc tới bên dưới đã bỏ.

v1.8.0

Astra, Sol và Luna trong Piagent

Pi 0.87.1 đưa ba model GPT-6 vào danh sách đã đăng nhập. Phiên mới ưu tiên Sol High; tier routing vẫn là lựa chọn bật riêng.

Luna

Việc gọn, rõ phạm vi và có thể kiểm tra: tier low ở Medium effort.

Sol

Công việc lập trình hằng ngày: tier medium/high; mặc định phiên mới ở High effort khi có quyền dùng.

Astra

Việc rộng hoặc mơ hồ: tier ultra ở Extra High. Model đã pin và phiên cũ được giữ nguyên.

Router chỉ chọn model có trong catalog đã đăng nhập; fallback 5.6 được ghi rõ. Kết quả 108 phiên cũ không phải phép đo GPT-6 và bản này không claim tiết kiệm token.

v1.7.1

Phiên dài giữ đúng việc, context và số liệu rõ ràng

v1.7.1 cập nhật Pi 0.86.1, sửa phục hồi phiên và bổ sung chờ trong phiên đang mở.

Chờ theo yêu cầu

Nhờ agent chờ tới lần kiểm tra tiếp theo; timer không gọi model trong khoảng chờ. Phiên phải còn mở.

Context và usage

Context ưu tiên file dùng được; token và kết quả kiểm tra được gắn đúng task.

Giới hạn bằng chứng

14 phiên từng lỗi đã PASS khi chạy lại riêng. Không gộp thành điểm 108 phiên mới hoặc claim tiết kiệm token tổng thể.

v1.6.1 · Reliability patch

UI đúng trạng thái, review repo ngoài an toàn, helper ít tốn hơn

Bản vá này giữ nguyên model và thinking level, nhưng siết chặt lifecycle để response chỉ hiện khi task thật sự hoàn tất, đồng thời giới hạn helper và quyền đọc source ngoài theo đúng session.

Conversation truth

Draft, retry và completion còn pending ở trong Activity. Chat giữ đúng thứ tự user rồi assistant và không tiếp tục hiện processing sau terminal.

External review

URL GitHub, GitLab và Bitbucket chỉ bật source checkout tối thiểu; runtime cấp quyền đọc chính xác checkout đó và vẫn chặn cache, credential, symlink escape cùng mọi mutation.

Solo-first

Direct subagent có trần một helper read-only, không auto retry/fork/worker và có giới hạn call, turn, thời gian. Kết quả thiếu bằng chứng được ghi là failure thật.

Product stabilization

Sáu thay đổi người dùng sẽ thấy

Workflow cũ vẫn chạy. Update này đưa thêm bằng chứng runtime và các gate fail-closed vào phía sau, rồi mở những projection ngắn để người dùng kiểm tra khi cần.

Runtime truth

Model, provider, thinking, context window và provenance được đọc từ runtime hoặc authenticated catalog. Fact chưa có giữ là unknown, không đoán từ tên model.

Task trajectory

Task đi qua plan, execute, verify, review, handoff và terminal bằng state có replay. Event stale, sai identity hoặc corrupt sẽ fail closed.

Recovery và resume

Lỗi được phân loại trước khi retry hoặc repair. Environment, provider, permission, policy và scope failure không bao giờ cấp quyền sửa source.

Role-bound helpers

Scout, planner, reviewer và Oracle nhận scope/tool/budget có giới hạn. Parent model được giữ nguyên; automatic worker và multi-writer vẫn tắt.

Completion receipt

Receipt chỉ approved khi trace completed, acceptance satisfied và hard gate trên working tree hiện tại pass. Thiếu verifier hoặc work plan còn pending phải giữ remaining risk.

Product views

Preflight, live status, activity inspector, efficiency và orchestration policy có output deterministic; người dùng không cần nhờ model nhớ hoặc diễn giải state.

Daily flow

Luồng dùng hằng ngày không bị phá

Giao task như trước

Dùng prompt tự nhiên (từ bản 1.9.0 /workflow đã bỏ). Không cần gọi preflight thủ công.

Runtime tự ghi nhận truth

Task Contract, context, changed files, trajectory và checkpoint được cập nhật từ hook/tool result thay vì trí nhớ của model.

Verify đúng working tree

Chỉ exact command đã quan sát, exit thành công và khớp current-tree digest mới được tính là passing evidence.

Recovery hoặc handoff có giới hạn

Source repair và transient retry có ceiling. Trường hợp không an toàn chuyển sang handoff/operator thay vì tiếp tục đoán.

Completion fail closed

Trace completed không đủ. Work plan, acceptance, changed-file integrity và verifier hiện hành phải cùng pass trước khi receipt approved.

Inspect when needed

Năm command để nhìn xuyên suốt luồng

Đây là command quan sát và chẩn đoán, không phải bước bắt buộc trước mỗi task.

Preflight, activity, status, metrics và helper policy
/task-preflight --json Review current repository state
/piagent-inspector
/piagent-status
/usage efficiency
/piagent-orchestration

Xem Workflow thay đổi thế nào để biết chính xác từng command đọc gì, không làm gì và nên dùng ở thời điểm nào.

Automatic vs opt-in

Cái gì tự chạy, cái gì cần bật rõ ràng

SurfaceMặc địnhHành vi
Runtime snapshot + task evidenceTự độngGhi fact, journal, verifier, recovery và receipt có giới hạn.
Activity inspectorPanel bốn dòng tự động, menu tùy chọnHiện task diff, command, safety và context sát footer; không gọi model và không đổi workflow state.
SolvershadowĐánh giá route nhưng không đổi parent model hoặc tự chiếm quyền workflow.
Phase toolsshadowTính projection; dùng PIAGENT_PHASE_TOOLS=on để áp tool visibility theo phase.
RecoveryonTự retry/repair trong ceiling; dùng PIAGENT_AUTO_RECOVERY=off để quay về ordinary handoff.
HelpersoffPIAGENT_HELPERS_MODE=on vẫn chỉ cho một helper read-only context fresh sau khi chứng minh hai lane độc lập và projected net saving từ 30%.
Parent routing + automatic workeroffKhông tự đổi parent model, không tự bật writer và không có multi-writer mặc định.

Compatibility

Không cần đổi thói quen hoặc migrate task cũ

Task Contract vẫn là v2.

Runtime snapshot, solver, trajectory, recovery và helper state là sidecar versioned/additive. Alias command cũ vẫn hoạt động; state cũ thiếu projection mới phải hiện unknown/unavailable thay vì được nâng cấp thành success.

Host không phải sandbox

Policy giảm lỗi trong tool surface được kiểm soát nhưng không cô lập code khỏi account của operator. External và destructive action vẫn cần confirmation.

Default giữ conservative

Solver/phase tools chưa được promote khỏi shadow, helpers chưa tự dispatch, parent routing và automatic worker vẫn off cho tới khi có rollout evidence riêng.

Try it

Test trực tiếp sau khi mở Pi session mới

Read-only product walkthrough
/task-preflight --json Review this repository without modifying files
/piagent-inspector
/piagent-status
/usage efficiency

Sau update package hoặc local checkout, mở Pi session mới để extension được reload. Dùng Command catalog cho toàn bộ command và alias.