CLI

Tra cứu các nhóm lệnh của you-agent-factory, cách một lần chạy chọn factory, các cờ toàn cục dùng chung cho mọi lệnh, và nơi đặt hợp đồng CLI đầy đủ đã công bố.

Cài đặt

Cài CLI you bằng điểm vào bản phát hành chính thức cho hệ điều hành của bạn, rồi cấu hình một nhà cung cấp trước lần chạy đầu tiên. Trang cài đặt có đủ lệnh cho từng hệ điều hành, bước chọn nhà cung cấp, và phần cài factory đóng gói.

Cài đặt you-agent-factory

Lệnh

Chọn nhóm lệnh theo việc bạn đang muốn làm, và kiểm tra xem nó có cần một máy chủ factory đang lắng nghe hay không. Các dạng khởi động tạo ra runtime. Các dạng phiên, công việc và gửi việc thì làm việc với một runtime đã tồn tại. Phần còn lại đọc hoặc ghi trạng thái cục bộ.

Nhóm lệnh	Mục đích	Factory có cần đang chạy sẵn không?
you init	Cấu hình nhà cung cấp và mô hình mặc định, hoặc cài một factory đóng gói từ danh mục tích hợp.	Không
you run	Nạp một factory và chạy engine. Mặc định theo lô; thêm --continuously để giữ sống khi rảnh.	Không — chính nó khởi động runtime.
you server	Kiểm tra và phục vụ factory hiện tại từ ./factory/factory.json, mở bảng điều khiển một lần khi sẵn sàng.	Không — chính nó khởi động runtime.
you factory list / create / update / delete	Quản lý các factory có tên đã lưu, mỗi lần trong đúng một thư mục gốc factory.	Không
you factory config validate / expand / flatten	Kiểm tra một định nghĩa mà không lưu lại, hoặc chuyển đổi giữa bố cục một tệp và bố cục tách rời.	Không
you session list / show / create / delete / pause / resume / dispatches	Quản lý các phiên factory và đọc các lượt điều phối bền vững của chúng trên một máy chủ.	Có
you submit / you submit batch	Gửi một hạng mục công việc, hoặc cập nhật trọn một lô yêu cầu chuẩn, vào một phiên đang hoạt động.	Có
you work list / show / move / visualize	Kiểm tra và chuyển các hạng mục công việc. Việc trực quan hóa tệp lô thì đọc JSON cục bộ.	Có, trừ visualize
you workers list / acp add / acp delete	Xem các tích hợp worker chọn được và cấu hình nhà cung cấp Agent Client Protocol.	Không
you models list / inspect / pull / invoke	Đọc các mô hình đã phát hiện và mức sẵn sàng của chúng, kéo mô hình cục bộ vào bộ nhớ đệm được quản lý, hoặc gọi trực tiếp một mô hình.	Có, trừ invoke
you mcp serve	Khởi động máy chủ Model Context Protocol cho Factory Session qua stdio để một nền tảng MCP dùng.	Không
you serve acp	Lưu trữ you-agent-factory như một tác tử Agent Client Protocol qua stdio cho trình soạn thảo.	Không
you docs / you docs <topic>	In markdown tham chiếu đi kèm từ tệp nhị phân đã cài.	Không

Tham chiếu CLI — mọi lệnh, cờ và tham số đã công bố

Chọn factory

Một lần chạy cần biết nạp factory nào, và có ba cách để nói điều đó. Factory có tên được phân giải từ ./factory trước, rồi mới tới thư mục gốc factory toàn cục. Cách chỉ định thư mục trỏ tới một bố cục factory trên đĩa. Factory di động là một tệp JSON hoặc YAML duy nhất, hay một thư mục không gây nhập nhằng, chạy tại chỗ mà không cần cài.

you run --named @you/goal "Ship the login bugfix"
you run --dir factory --work ./docs/examples/startup-work.json
you run --factory ./factory.yaml "Fix the lint issues"

Khi không có bộ chọn nào, lần chạy sẽ kiểm tra tệp ./factory/factory.json ngay tại nơi gọi lệnh như là factory hiện tại. Nó không tự dựng một định nghĩa còn thiếu và không đi theo con trỏ current-factory nào khác, nên chạy nhầm thư mục sẽ thất bại trước khi bất cứ thứ gì khởi động, thay vì lặng lẽ chọn một factory khác.

Cờ toàn cục

Bốn cờ dùng được với mọi lệnh và được viết trước lệnh con. Đầu ra có cấu trúc phát JSON ra stdout trong khi thông tin chẩn đoán ở lại stderr — chính điều đó khiến CLI dùng được trong script. Cờ server đặt URI gốc của API factory: các lệnh client HTTP nhắm vào đó, còn những lần chạy có bật máy chủ sẽ gắn vào host loopback và cổng của nó.

you --json factory list
you --server http://127.0.0.1:7437 session list
you --verbose run --named @you/review "Draft the release notes"

Cờ --port theo từng lệnh đã lỗi thời, hãy dùng cờ toàn cục --server. Nên dùng URI gốc: nó gói cả giao thức, host và cổng trong một giá trị và áp dụng nhất quán.

Tham chiếu ngoại tuyến

Tệp nhị phân mang theo các chủ đề tham chiếu của chính nó và in được mà không cần kết nối mạng hay máy chủ đang chạy. 21 chủ đề bao phủ việc soạn factory, chạy, cấu hình, worker giả lập, ghi và phát lại, guard, quan hệ, công việc, phiên, bộ điều phối, quy trình JavaScript, MCP, workstation, worker, tài nguyên, mô hình, đầu vào theo lô và mẫu.

you docs
you docs agents

Cách khiến tác tử của bạn dùng YOU

Giới hạn và giả định

Phạm vi ở đây là nhóm lệnh, cách chọn factory và cờ toàn cục. Toàn bộ cờ, tham số, mã thoát và trạng thái vòng đời của từng lệnh nằm ở trang tham chiếu CLI, vốn được chiếu thẳng từ hợp đồng của gói đã cài chứ không chép tay. Các thao tác HTTP nằm ở trang tham chiếu API.

CLI