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.

On this page
A save lands on mainTwo people, one fileOfflineFiles that wait for an approvalCommands

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.

terminalon main
1agentflare init        # make this folder a project2agentflare status      # where you stand: your access, who's online, anything waiting on you

Each 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:

terminalon main
1agentflare approve lvcs.toml

Until then, the rest of the project carries on without it. The [protect] section of the lvcs.toml reference lists which paths are protected.

Commands

CommandWhat it does
agentflare initMake a folder a project you own.
agentflare join <project>Bring a project you've been let into onto this machine.
agentflare statusYour access, who's online, and what's waiting on you.
agentflare diffHow 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.