docs/generated/live.mdgenerated from code
How Agentflare works · 2 min read
Live editing
One main everyone edits at once: saves, same-line edits, offline, approvals.
In af there is one version of a project, main, and everyone edits it together: people, agents, and every machine the project is on. There are no branches, no pull requests, no rebases, and no merges.
A save lands on main
Saving a file is the whole step. Save from your editor, a script, or an agent, and the change is on main the moment you make it, with no commit to write. It reaches every machine the project is on as soon as they're connected, and each of those machines writes it to its copy of the project folder.
1agentflare init # make this folder a project2agentflare status # where you stand: your access, who's online, anything waiting on youEach save says who made it. A file's history, line by line, is in the Code tab.
Two people, one file
When two people, or a person and an agent, edit the same file at the same moment, both keep their edits. If both edit the same line, both edits survive in that line: there are no conflict markers, and no one picks whose work to keep.
Before an agent edits lines you're working on, you hear about it. The af plugins for Claude Code and OpenCode announce the lines an agent is about to change, so the other people and agents editing that file see it and can take other lines. Agents and access has more.
Offline
Your machine keeps working when it's offline. Your saves wait on it, and the others' saves arrive when it reconnects; both sides end with every edit.
Files that wait for an approval
A few files change how the whole project behaves, like lvcs.toml. A save to one of these, a protected path, waits until someone with approve access approves it:
1agentflare approve lvcs.tomlUntil then, the rest of the project carries on without it. The [protect] section of the lvcs.toml reference lists which paths are protected.
Commands
| Command | What it does |
|---|---|
agentflare init | Make a folder a project you own. |
agentflare join <project> | Bring a project you've been let into onto this machine. |
agentflare status | Your access, who's online, and what's waiting on you. |
agentflare diff | How your folder differs from main. |
agentflare read <path> | A file as main holds it. |
agentflare restore <path> | Put main's version back over your folder's. |