Let your agent edit shared notes

On this page

Your AI coding agent, such as Claude Code, can work on your team's shared notes the same way it works on any other files: it edits the files on your disk. Relay then carries those edits to everyone else. That works even while notes are closed and while teammates are editing, as long as Obsidian is running.

What you need

Your files need to be in a Shared Folder.

Agents also work with Relay versions before 0.8.12, but edits saved outside Obsidian were more likely to need resolving by hand.

For setup, install Relay, share a folder, and invite your collaborators.

Before a broad rewrite, back up the notes you want to preserve.

Have your agent edit a shared note

Give your agent the path to the note and describe the change you want. The agent reads and edits the file, then saves it to disk. Relay picks up the saved file, merges it with your teammates' edits, and syncs the result.

Agent File on disk Relay Teammates’ notes
The path of one saved edit: your agent saves the file on disk, and Relay carries the edit to your teammates’ copies of the note.

What to expect

A teammate edits at the same time

Your teammates can keep editing while the agent works, and the saved changes appear in the shared note. Relay combines saved changes, but it doesn't judge whether they make sense together. Review the combined result when both change the same passage.

Obsidian is closed

The agent can edit local files while Obsidian is closed, but those changes aren't shared until you reopen it. Relay normally reconciles them automatically; rare local conflicts can occur when the same lines were changed in different ways.

For details, see how devices exchange saved changes and how Relay brings edits together.