Ba bước, từ máy trắng tới portal đang chạy. Không có bước "khởi động daemon" riêng — lệnh nào cần daemon thì tự dựng một cái.

$ curl -fL https://agentdc.nqdiepoii.com/download/linux-amd64/agentdc-linux-amd64 -o agentdc
chmod +x agentdc
./agentdc

# cài, và cũng là lệnh cập nhật
$ irm https://…/install.ps1 | iex

# cài app và lối tắt nhưng chưa mở AgentDC
$ & ([scriptblock]::Create((irm https://…/install.ps1))) -NoStart

$ $AgentDC = "$env:LOCALAPPDATA\Programs\AgentDC\agentdc.exe"
$ Set-Alias -Name agentdc -Value $AgentDC

$ agentdc doctor

[ok]   windows        build 26200 >= 17763
[ok]   agent binary   claude
[ok]   git            2.51.0
[ok]   config         C:\Users\you\AppData\Local\agentdc
[--]   daemon         not running (the CLI starts one on demand)

Hai biến quyết định tất cả

Cả hai đều tuỳ chọn:

Một daemon cho một AGENTDC_HOME. Muốn chạy con thứ hai thì đổi AGENTDC_HOME, không phải chỉ đổi cổng — đổi mỗi cổng thì nó từ chối và nói thẳng lý do.

Ba loại log, ba chỗ

Tất cả nằm trong <AGENTDC_HOME>.

$ agentdc portal
portal: http://127.0.0.1:8770/?k=…

Lệnh này làm ba việc: dựng daemon ở nền nếu chưa có, đúc một khoá dùng-một-lần, và mở trình duyệt vào portal.

agentdc app là lệnh CLI tương đương để mở phiên app có Terminal nhìn thấy được. Lối tắt Desktop, Start/Search và file tải về khi nhấp đúp đều chạy AgentDC không truyền đối số.

Dự án và cuộc chat

1. Sidebar → + Thêm dự án → trỏ vào một thư mục làm việc.
2. Sidebar → + Thêm cuộc chat → chọn dự án + agent.

Dự án là ngữ cảnh làm việc: agent sinh ra trong dự án nào thì chạy với thư mục đó làm cwd. Bộ nhớ dài hạn gắn theo dự án, không theo cuộc chat — hai cuộc chat cùng dự án dùng chung một cây trụ cột.

Làm được cả từ CLI:

# thêm dự án rồi mở một phiên agent trong đó
$ agentdc project add myapp C:\code\myapp
$ agentdc spawn myapp

# gửi prompt và xem output tới khi agent rảnh
$ agentdc send <sid> "đọc README rồi nói nó làm gì"

Chế độ an toàn

Trong hộp thoại mở chat có một công tắc Chế độ an toàn: agent chạy ở chế độ thường, không có cờ bỏ hỏi-quyền, và daemon nối thêm một system prompt nói rõ giới hạn ngay từ byte đầu. Bật nó cho cuộc chat nào sẽ đứng trước người ngoài.

Phiên sống bền

Agent chạy trong ConPTY do daemon giữ, không phải terminal của bạn. Đóng terminal chỉ dùng cho CLI/attach, đóng tab portal, đăng xuất — phiên vẫn sống và vẫn ghi transcript. Đừng nhầm nó với Terminal AgentDC do shortcut mở: cửa sổ đó giữ daemon, nên đóng nó hoặc nhấn Ctrl+C sẽ tắt AgentDC và các phiên đang sống.

# nối terminal này vào một phiên đang sống; Ctrl-] để rời ra
$ agentdc attach <sid>

# hoặc chỉ xem lại transcript
$ agentdc logs <sid>

Một prompt, N agent, N git worktree riêng — rồi so kết quả cạnh nhau và tự chọn bản để lấy.

$ agentdc fanout myapp --n 3 "thêm test cho parser"
run 7f3a: 3 worktrees branched from commit 1c9de2f
3/3 agents completed

# so ba bản cạnh nhau
$ agentdc fanout diff 7f3a

# xem patch đầy đủ của bản số 2
$ agentdc fanout diff 7f3a 2

# dọn worktree, branch và bản ghi
$ agentdc fanout clean 7f3a

--n nhận từ 2 đến 8. Dự án phải là một git repo đã có commit — hai điều kiện đó bị từ chối ngay ở client, với hai câu lỗi khác nhau.

Portal là giao diện chính; CLI là cho việc script hoá và cho lúc portal không lên. Mọi lệnh đều có --help.

Các lệnh bên dưới dùng alias của phiên PowerShell, vì AgentDC không được thêm vào PATH:

$ $AgentDC = "$env:LOCALAPPDATA\Programs\AgentDC\agentdc.exe"
$ Set-Alias -Name agentdc -Value $AgentDC

Alias chỉ tồn tại trong cửa sổ PowerShell hiện tại; mọi ví dụ agentdc … sau đây đều gọi executable ở đường dẫn chuẩn.

Định dạng máy đọc

$ agentdc ls --json | ConvertFrom-Json
$ agentdc status --json

ls, status, fanout list và fanout diff đều nhận --json. Danh sách rỗng trả về [], không bao giờ null.

Một endpoint AgentDC cho mọi MCP client tương thích. Codex, Claude Code và OpenCode là ba cấu hình hiện có dưới đây; agent mới dùng lại cùng hợp đồng này.

AgentDC phải đang chạy trong Terminal để agent kết nối tới http://127.0.0.1:8770/mcp. MCP dùng cùng daemon, dự án, phiên và bộ nhớ với portal; nó không mở thêm app và không gửi một prompt khởi đầu vào phiên.

Codex

Thêm server sau vào ~/.codex/config.toml, rồi mở lại Codex:

[mcp_servers.agentdc]
url = "http://127.0.0.1:8770/mcp"
http_headers = { Authorization = "Bearer <TOKEN>" }
tool_timeout_sec = 1200

Claude Code

Đăng ký ở scope người dùng để AgentDC có mặt trong mọi dự án:

$ claude mcp add --transport http --scope user agentdc http://127.0.0.1:8770/mcp --header "Authorization: Bearer <TOKEN>"
$ claude mcp get agentdc

OpenCode 1.x

Thêm server từ xa vào cấu hình OpenCode đang dùng, rồi mở lại OpenCode:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agentdc": {
      "type": "remote",
      "url": "http://127.0.0.1:8770/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer <TOKEN>"
      }
    }
  }
}

Công cụ

Ba công cụ liệt kê nhận cursor/limit và trả next_cursor; search_memory dùng before/next_before. Toàn bộ kết quả gửi trên wire, gồm cả text fallback cho MCP client cũ, được giới hạn ở 256 KiB và báo truncated; số project, session hay agent tăng lên vẫn không làm tràn ngữ cảnh của client.

MCP chỉ cung cấp các thao tác được kiểm soát ở trên. Xoá dự án, xoá lịch sử, tắt daemon và áp dụng cập nhật vẫn cần người dùng thực hiện trực tiếp trong AgentDC.

Daemon kiểm bản mới ngay khi khởi động, sau đó mỗi một phút. Có bản mới thì một dải đỏ hiện ở đỉnh portal; bấm vào đó sẽ mở hộp tiến trình với ghi chú bản vá, phần trăm và số byte tải thật, bước kiểm sha256 và trạng thái cài đặt.

Terminal AgentDC vẫn là dòng trạng thái liên tục: nó in lần kiểm phiên bản, ghi chú bản vá, các mốc tải, bước kiểm tra, thay bản, lỗi nếu có và lúc bản mới đã sẵn sàng để dùng.

Cập nhật chỉ thay mã ứng dụng: AgentDC tải nguyên binary phát hành mới, không chép nối vài MB vào binary cũ. Bản đang chạy được đổi tên tạm thành agentdc.exe.old, bản mới nhận tên agentdc.exe. Daemon hiện tại vẫn chạy từ bản .old, nên mọi phiên agent tiếp tục nguyên trạng; lần mở app kế tiếp dùng bản mới và tự dọn bản .old.

Database, cấu hình, lịch sử và toàn bộ AGENTDC_HOME vẫn được dùng tại chỗ, không bị sao chép theo binary và không bao giờ nằm trong gói tải. Chỉ dung lượng tệp chương trình tạm tăng gần gấp đôi trong khoảng từ lúc cài tới lần mở app kế tiếp.

Kích hoạt bản mới

Sau khi Terminal báo đã cài, tiếp tục dùng các phiên hiện tại bình thường. Khi thuận tiện, đóng Terminal rồi mở AgentDC từ shortcut. Có thể chạy thẳng app chuẩn bằng PowerShell:

$ & "$env:LOCALAPPDATA\Programs\AgentDC\agentdc.exe"

Chi tiết lần cập nhật nằm ở <AGENTDC_HOME>\update-apply.log; lỗi khởi động và trạng thái chạy nằm ở <AGENTDC_HOME>\daemon.log. Mặc định <AGENTDC_HOME> là %LOCALAPPDATA%\agentdc.

Tắt việc kiểm

Bản go build tự dựng không có kênh cập nhật và không gọi ra mạng — dải cập nhật sẽ không hiện.