Đồng bộ với Obsidian

Giữ ghi chú của bạn trong Obsidian.
Các agent cũng đọc và ghi được chúng.

Liên kết một thư mục trong kho Obsidian với một dự án. Những gì bạn viết trong Obsidian trở thành bộ nhớ mà các agent lập trình AI của bạn đọc trước khi bắt đầu, và những gì chúng học được quay về kho dưới dạng Markdown, giữ nguyên các [[links]].

Không cần cài plugin trong Obsidian, không cần gói Obsidian Sync, không cần chạy agent bên trong kho. AgentsRoom theo dõi thư mục trên đĩa khi ứng dụng máy tính đang chạy và có kết nối Internet, và cùng những ghi chú đó đến được Claude Code, Codex, GitHub Copilot CLI hay bất kỳ CLI agent nào khác bạn khởi chạy trên dự án.

Một phiên làm việc thật, quay ngay trong ứng dụng: Đồng bộ với Obsidian, trong Bộ nhớ dự án, liên kết một thư mục của kho Obsidian theo cả hai chiều. Hai ghi chú trong kho xuất hiện trong bộ nhớ, kèm mô tả và thẻ. Một agent được nhờ viết hàm hiển thị giá sẽ xem bộ nhớ trước và làm theo quy tắc giá được viết trong Obsidian. Khi được yêu cầu lưu những gì đã học, agent thêm một mục vào chính ghi chú đó, và ghi chú quay về thư mục của kho dưới dạng Markdown, giữ nguyên các liên kết.

Xem trên YouTube

Một thư mục, một bộ nhớ, mọi agent
Thư mục trong kho Obsidian
architecture.md
auth-decisions.md
release-runbook.md
Bộ nhớ dự án
architecture.md
auth-decisions.md
release-runbook.md
Agent
Claude Code
Codex
GitHub Copilot CLI
Xung đột: bạn quyết định

Ghi chú sửa trong Obsidian đến được bộ nhớ, ghi chú do agent lưu sẽ nằm trong kho. Hai chỉnh sửa trên cùng một ghi chú sẽ chờ bạn.

Nhiều lập trình viên đã lưu giữ suy nghĩ của mình trong Obsidian: ghi chú kiến trúc, các quyết định, runbook, lý do một module được xây dựng theo cách đó. Claude Code và các CLI agent khác bắt đầu mỗi phiên mà không có chút nào trong số đó, trừ khi bạn tự dán vào hoặc chạy agent bên trong kho.

AgentsRoom vốn đã cho mỗi dự án một bộ nhớ mà các agent đọc trước khi đi sâu vào code và ghi thêm trong lúc làm việc. Đồng bộ với Obsidian nối hai thứ đó lại. Bạn chọn một thư mục trong kho, và các ghi chú Markdown trong đó trở thành ghi chú trong bộ nhớ của dự án ấy. Theo chiều ngược lại, các ghi chú mà agent lưu được ghi vào thư mục, kèm siêu dữ liệu đầu tệp (frontmatter) và [[wiki-links]], nên Obsidian vẫn là trình soạn thảo và đồ thị của bạn.

Đây là đồng bộ, không phải nhập một lần, và nó không bao giờ tự phân xử thay bạn. Khi cùng một ghi chú thay đổi ở cả hai phía giữa hai lượt đồng bộ, hoặc bị xóa ở một phía, cả hai phiên bản đều được giữ lại và ghi chú đó chờ đến khi bạn chọn. Mọi ghi chú khác vẫn tiếp tục được đồng bộ.

Đồng bộ với Obsidian làm được gì

Một thư mục trong kho của bạn, một dự án, cùng những ghi chú cho mọi agent.

Hai chiều

Chỉnh sửa trong Obsidian cập nhật bộ nhớ dự án. Ghi chú do agent tạo hoặc thay đổi được ghi vào thư mục dưới dạng Markdown, và các ghi chú đã có trong bộ nhớ cũng được xuất ra đó.

Hoặc chỉ từ kho sang bộ nhớ

Bạn muốn không gì chạm vào kho của mình? Chế độ này chỉ đọc thư mục. Agent vẫn đọc ghi chú của bạn, nhưng không gì chúng ghi ra lại xuất hiện trong Obsidian.

Xung đột chờ bạn

Không có chuyện người ghi sau cùng thắng. Hai chỉnh sửa trên cùng một ghi chú, hoặc một chỉnh sửa đối lập với một thao tác xóa, sẽ dừng riêng ghi chú đó và hiển thị cả hai phiên bản, bản của Obsidian và bản của bộ nhớ. Bạn chọn giữ bản nào.

Giữ nguyên liên kết và thuộc tính

Liên kết [[note#heading|alias]], phần nội dung Markdown và các thuộc tính YAML bạn đã thêm vẫn giữ nguyên. Ghi chú do agent viết có mô tả và thẻ trong siêu dữ liệu đầu tệp (frontmatter).

Mọi CLI agent

Các ghi chú trở thành ghi chú bộ nhớ thông thường, được Claude, Codex, GitHub Copilot CLI, Cursor và 10 CLI agent khác mà AgentsRoom hỗ trợ đọc qua cùng bộ công cụ bộ nhớ.

Nhiều máy tính

Liên kết thuộc về tài khoản của bạn. Trên máy tính khác, dự án hiển thị liên kết này và yêu cầu bạn xác định vị trí thư mục tương ứng trong kho trên máy đó. Ngắt liên kết sẽ dừng đồng bộ trên mọi máy tính.

Thanh công cụ cửa sổ bộ nhớ của AgentsRoom: Graph view, Import from Obsidian, Obsidian sync, Import from project và New memory, phía trên dòng lưu ý cho biết bộ nhớ được lưu phía máy chủ và chia sẻ với mọi người mở dự án
Nằm ở đâu: Đồng bộ với Obsidian nằm trên thanh công cụ của bộ nhớ dự án, cạnh Nhập từ Obsidian, dùng để nhập một lần.

Cách hoạt động

Bốn bước. Ba bước đầu chỉ làm một lần cho mỗi dự án.

  1. 1

    Mở bộ nhớ dự án

    Trong dự án, mở Bộ nhớ dự án từ dock (biểu tượng bộ não). Trên thanh công cụ của nó, nhấn Đồng bộ với Obsidian.

  2. 2

    Chọn thư mục trong kho

    Nhấn Chọn thư mục trong kho và chọn kho của bạn hoặc một thư mục con của nó. Một thư mục dự án vài trăm ghi chú phù hợp hơn cả kho: mọi ghi chú trong đó sẽ được chia sẻ với dự án.

  3. 3

    Chọn chiều và liên kết

    Ở Chiều đồng bộ, chọn Hai chiều hoặc Chỉ từ kho sang bộ nhớ, đọc thông báo về việc chia sẻ, rồi nhấn Liên kết thư mục này. Lượt đồng bộ đầu tiên chạy ngay.

  4. 4

    Bạn viết, và để agent cùng viết

    Cứ tiếp tục chỉnh sửa trong Obsidian. AgentsRoom nhận các tệp đã lưu trong vài giây và kiểm tra bộ nhớ mỗi 30 giây, không cần mở bảng. Đồng bộ ngay buộc chạy một lượt; Xung đột cần giải quyết liệt kê các ghi chú đang chờ bạn chọn.

Bảng Obsidian sync của AgentsRoom trước khi liên kết thư mục: thông báo rằng mọi ghi chú Markdown trong thư mục được chia sẻ với dự án, nút Choose a vault folder, menu Sync direction đặt ở Both ways và nút Link this folder
Bảng Đồng bộ với Obsidian: chọn một thư mục trong kho, chọn chiều (Hai chiều hoặc Chỉ từ kho sang bộ nhớ), đọc thông báo về việc chia sẻ, rồi liên kết thư mục.

Những gì Obsidian và các CLI agent tự làm được

Bạn không cần AgentsRoom để cho agent làm việc với ghi chú của mình. Cách đơn giản nhất là khởi chạy Claude Code hoặc Codex bên trong thư mục kho: ghi chú là tệp Markdown, và agent đọc, sửa chúng như code. Các plugin cộng đồng còn đi xa hơn và đưa agent vào ngay trong Obsidian. Claudian chẳng hạn mở Claude Code, Codex, OpenCode và các agent khác trong thanh bên, với kho làm thư mục làm việc.

Cũng có những cầu nối cho agent làm việc ở nơi khác. Các MCP server như mcp-obsidian cho phép truy cập kho qua plugin cộng đồng Local REST API, nghĩa là Obsidian phải đang mở. Từ phiên bản 1.12, Obsidian có sẵn dòng lệnh riêng (Settings, General, Command line interface) với các lệnh như read, search, create và append, và nó cũng giao tiếp với ứng dụng đang chạy.

Đồng bộ với Obsidian đáp ứng một nhu cầu khác. Agent của bạn làm việc trong một repository code, không phải trong kho, và bạn muốn những ghi chú quan trọng với dự án đó nằm trong những gì mọi agent đọc trước khi bắt đầu, trên mọi máy tính và cho mọi đồng đội trong dự án. Tính năng đồng bộ đọc và ghi tệp trên đĩa, nên Obsidian không cần mở, và nó giữ xung đột lại cho bạn thay vì để người ghi sau cùng thắng. Nó hoạt động song song với bất kỳ cách thiết lập nào ở trên.

Điều cần biết

  • Đồng bộ chạy khi ứng dụng máy tính AgentsRoom đang chạy và có kết nối Internet. Những chỉnh sửa trong Obsidian khi ứng dụng đóng sẽ được nhận ở lượt đồng bộ tiếp theo.
  • Mọi ghi chú Markdown trong thư mục đã liên kết được chia sẻ với tất cả những ai có quyền truy cập bộ nhớ dự án, và bộ nhớ được lưu trên máy chủ của AgentsRoom. Hãy liên kết một thư mục dự án, không phải một kho đầy ghi chú cá nhân, và đừng để bí mật trong đó.
  • Tối đa 2.000 ghi chú, 1 MB mỗi ghi chú và tổng cộng 16 MB, tám cấp thư mục con. Tệp đính kèm, thư mục ẩn và liên kết tượng trưng bị bỏ qua.
  • Mỗi dự án một thư mục trong kho. Một thư mục không thể chồng lấn với thư mục đã liên kết với dự án khác.
  • Khi agent đổi tên hoặc di chuyển một ghi chú trong bộ nhớ, tệp vẫn giữ đường dẫn trong kho, nên các liên kết của bạn không bị hỏng. Một ghi chú bị đổi tên và chỉnh sửa trong Obsidian giữa hai lượt đồng bộ có thể quay lại dưới dạng một ghi chú mới kèm một thao tác xóa cần xác nhận: không gì bị xóa nếu bạn chưa chọn.
  • Việc liên kết thư mục và giải quyết xung đột được thực hiện trên máy tính. Các agent bạn điều khiển từ ứng dụng di động đọc cùng những ghi chú đó.

Câu hỏi thường gặp

Claude Code có đọc được kho Obsidian của tôi không?

Có, các ghi chú trong thư mục bạn liên kết. Chúng trở thành ghi chú của bộ nhớ dự án, và mọi agent bạn khởi chạy trên dự án, kể cả Claude Code, đều được dặn kiểm tra bộ nhớ đó trước khi khám phá code. Agent không cần chạy bên trong kho, và Obsidian không cần mở.

Agent của tôi có ghi vào kho của tôi không?

Chỉ khi bạn chọn Hai chiều. Khi đó, các ghi chú agent tạo hoặc thay đổi được ghi vào thư mục đã liên kết dưới dạng Markdown, kèm mô tả và thẻ trong siêu dữ liệu đầu tệp (frontmatter), và giữ nguyên các [[links]]. Với Chỉ từ kho sang bộ nhớ, không có gì được ghi vào kho.

Chuyện gì xảy ra nếu tôi sửa một ghi chú trong Obsidian trong khi agent đang thay đổi nó?

Ghi chú đó dừng lại và hiển thị cả hai phiên bản, bản Obsidian và bản Bộ nhớ dự án, cho đến khi bạn chọn một. Thao tác xóa ở một phía cũng chờ bạn chọn. Các ghi chú khác vẫn tiếp tục đồng bộ. Nếu một trong hai phiên bản lại thay đổi trước khi bạn quyết định, bạn sẽ xem lại xung đột đã cập nhật trước.

Tôi có cần plugin Obsidian, Obsidian Sync hay Local REST API không?

Không. AgentsRoom đọc và ghi trực tiếp các tệp Markdown của thư mục trên đĩa. Không có gì được cài vào Obsidian, ứng dụng Obsidian không cần mở, và việc đồng bộ không dùng Obsidian Sync. Tuy nhiên, ứng dụng máy tính AgentsRoom cần đang chạy và có kết nối Internet.

Những CLI agent nào dùng được ghi chú từ kho của tôi?

Toàn bộ 14 CLI agent mà AgentsRoom hỗ trợ (Claude, Codex, GitHub Copilot CLI, Cursor và 10 CLI agent khác). Ghi chú từ kho là ghi chú bộ nhớ thông thường, được đọc qua cùng bộ công cụ bộ nhớ như những ghi chú do chính agent viết.

Ai có thể thấy các ghi chú của thư mục đã liên kết?

Tất cả những ai có quyền truy cập bộ nhớ dự án, vốn được chia sẻ với mọi người làm việc trên dự án và lưu trên máy chủ của AgentsRoom. Đó là lý do bạn phải tự chọn thư mục và bảng cảnh báo bạn trước khi liên kết. Hãy liên kết thư mục thuộc về dự án, không phải cả kho, và đừng bao giờ để mật khẩu hay khóa trong đó.

Nó có hoạt động trên nhiều máy tính không?

Có. Liên kết được lưu trong tài khoản của bạn. Trên máy tính thứ hai, dự án hiển thị liên kết này và yêu cầu bạn xác định vị trí thư mục tương ứng trong kho trên máy đó, vì đường dẫn khác nhau giữa các máy. Ngắt liên kết sẽ dừng đồng bộ ở mọi nơi và giữ nguyên ghi chú cũng như tệp ở chỗ cũ.

Khác gì so với Nhập từ Obsidian?

Nhập từ Obsidian sao chép ghi chú vào bộ nhớ một lần, và bạn chọn những ghi chú nào. Đồng bộ với Obsidian từ đó về sau giữ một thư mục và bộ nhớ luôn khớp nhau, theo cả hai chiều hoặc chỉ từ kho, và xử lý xung đột. Cả hai nút đều nằm trên thanh công cụ của bộ nhớ dự án.

Tìm hiểu thêm

Có thể bạn cũng thích

Trao cho agent những ghi chú bạn vốn đã có

Liên kết một thư mục trong kho với một dự án và để Claude Code, Codex cùng mọi CLI agent bắt đầu từ những gì bạn đã ghi lại.

Miễn phíTải AgentsRoom

Ứng dụng đồng hành: theo dõi agent khi đi đường

Sử dụng Claude, Codex, Antigravity CLI hoặc nhà cung cấp AI khác.

Tải tiện ích mở rộng
Chrome Web Store

Gửi lỗi và yêu cầu thẳng vào backlog công khai của bạn.

Nhiều dự án
Đa nhà cung cấp
Nhiều agent
Trạng thái trực tiếp
File diff & commit
Ứng dụng đồng hành mobile
Xem trước trực tiếp
Đội agent
Tự động hóa trình duyệt
Dev theo backlog
Thư viện prompt
Thư viện skill
Xem tất cả tính năng