agentflare --helpas the release prints it
Use · 24 min read
CLI
Every agentflare command and flag, as its --help prints it.
On this page
agentflareagentflare daemonagentflare installagentflare uninstallagentflare joinagentflare initagentflare projectagentflare forgetagentflare keyagentflare key newagentflare key releaseagentflare replayagentflare auditagentflare migrateagentflare statusagentflare explainagentflare authagentflare auth loginagentflare auth statusagentflare auth logoutagentflare notifyagentflare addagentflare approveagentflare readagentflare writeagentflare diffagentflare mvagentflare rmagentflare restoreagentflare grantagentflare pluginagentflare plugin installagentflare plugin listagentflare plugin upgradeagentflare plugin removeagentflare plugin enableagentflare plugin disableagentflare plugin resolveagentflare revokeagentflare purgeagentflare update
Read as
Every agentflare command and flag, as agentflare <command> --help prints it.
agentflare
1af — live, local-first version control for agents and humans23Usage: agentflare [OPTIONS]4 agentflare <COMMAND>56Commands:7 daemon Run this user's LVCS daemon in the foreground8 install Install the daemon as a service that starts at login, and start it9 uninstall Stop the daemon and remove its service, leaving every project alone10 join Join an existing project from its nodes into a directory11 init Make a directory an LVCS project that you own, hosted by the daemon12 project Host an initialized project, or change how it is hosted13 forget Stop hosting a project, leaving its files alone14 key Manage peer keys15 replay Check that the project's journal replays to the same state16 audit Check that every stored change is signed and authorized, and that no secret is stored17 migrate Bring a project's LVCS files to this version's format18 status Show where you stand in this project, one line per item19 explain Explain an error code, rule, recovery, or notification kind, or how a path is classified20 auth Pair devices such as the app in a browser, list them, and revoke them21 notify Show your notifications: what needs you, in LVCS's own words22 add Save a file as it is on disk, sending its refused save again23 approve Approve changes to protected paths, at main's frontier when the daemon serves the request24 read Print a file's body as main holds it, or as a frontier does25 write Save stdin as a file's new body, against the heads it was made from26 diff Show how your main tree's files differ from main's27 mv Rename a file, or a directory's files, keeping their history and blame28 rm Delete files, against the heads they were read at29 restore Write main's version over your main tree's files, discarding their unsaved or refused bytes30 grant Let a peer read, write, or more on some paths31 plugin Install, list, upgrade, and remove plugins32 revoke Take back a grant, and every renewal of it33 purge Purge deleted files' documents from the project, as its owner34 update Update lvcs to the latest signed release and restart the daemon35 help Print this message or the help of the given subcommand(s)3637Options:38 -V, --version Print `agentflare <version>`39 --verbose With --version, also print the build's commit, target, profile, and features, one `<name>: <value>` line each40 -h, --help Print help4142Edits are saved as you write them: there is no commit step, and agentflare status says where things stand.4344Plugins add more commands in a project: issue, discussion, action, message, and secret come with af (agentflare plugin list names a project's).agentflare daemon
1Run this user's LVCS daemon in the foreground.23It hosts every project you initialized or joined, until SIGINT or SIGTERM. `agentflare install` runs it as a service instead.45Usage: agentflare daemon [OPTIONS]67Options:8 --relay9 Also serve as a public circuit relay for nodes and browsers behind NAT: the host node stays on, listens on TCP 4402 beside UDP 4401, and relays for any node1011 -h, --help12 Print help (see a summary with '-h')agentflare install
1Install the daemon as a service that starts at login, and start it.23A launchd agent on macOS, a systemd user unit on Linux, a Scheduled Task on Windows. Run again, it rewrites the service and restarts the daemon.45Usage: agentflare install67Options:8 -h, --help9 Print help (see a summary with '-h')agentflare uninstall
1Stop the daemon and remove its service, leaving every project alone23Usage: agentflare uninstall45Options:6 -h, --help Print helpagentflare join
1Join an existing project from its nodes into a directory.23Prints your new peer id, the project id, and this node's id. Exits 1 with "join incomplete" when no node delivers every file in time; the daemon then finishes the sync.45Usage: agentflare join [OPTIONS] <PROJECT>67Arguments:8 <PROJECT>9 The project id, as `agentflare init` printed it1011Options:12 --root <ROOT>13 The directory to join into, created when missing (default: the current directory)1415 --seed16 Run as a seed node: pin every document, serve as a circuit relay, and act as a bootstrap address, with no special authority1718 --listen <MULTIADDR>19 A multiaddr to listen on (repeatable; default: every interface, a port the system picks, TCP and QUIC)2021 --bootstrap <MULTIADDR>22 A multiaddr to dial at start, including its `/p2p/<node id>` (repeatable)2324 --no-mdns25 Don't look for nodes on the local network (mDNS); find them only through bootstrap addresses, the DHT, and relays2627 -h, --help28 Print help (see a summary with '-h')agentflare init
1Make a directory an LVCS project that you own, hosted by the daemon.23Prints your owner id, the project id, and this node's id.45Usage: agentflare init [OPTIONS]67Options:8 --root <ROOT>9 The project root (default: the current directory)1011 --name <NAME>12 The name you're shown by (default: your OS user name). `owner` still names you everywhere, as in `--as owner`1314 --seed15 Run as a seed node: pin every document, serve as a circuit relay, and act as a bootstrap address, with no special authority1617 --listen <MULTIADDR>18 A multiaddr to listen on (repeatable; default: every interface, a port the system picks, TCP and QUIC)1920 --bootstrap <MULTIADDR>21 A multiaddr to dial at start, including its `/p2p/<node id>` (repeatable)2223 --no-mdns24 Don't look for nodes on the local network (mDNS); find them only through bootstrap addresses, the DHT, and relays2526 -h, --help27 Print help (see a summary with '-h')agentflare project
1Host an initialized project, or change how it is hosted.23Sets who authors changes made on disk, how the project reaches its nodes, and what its public listing says, then opens it again. Prints the result as one line of JSON.45Usage: agentflare project [OPTIONS]67Options:8 --root <ROOT>9 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)1011 --as <PEER>12 The default peer, which authors changes made on disk in the project's root tree (default when registering: the owner); another peer's main tree is authored by that peer1314 --seed15 Run as a seed node: pin every document, serve as a circuit relay, and act as a bootstrap address, with no special authority1617 --listen <MULTIADDR>18 A multiaddr to listen on (repeatable; default: every interface, a port the system picks, TCP and QUIC)1920 --bootstrap <MULTIADDR>21 A multiaddr to dial at start, including its `/p2p/<node id>` (repeatable)2223 --no-mdns24 Don't look for nodes on the local network (mDNS); find them only through bootstrap addresses, the DHT, and relays2526 --mdns27 Find nodes on the local network again after `--no-mdns`2829 --title <TITLE>30 The name the project's listing on lvcs.sh's Explore and Trending shows in place of the project's own (fixed by its id), at most 64 bytes (empty clears it). The listing is published while anyone may read the project (`agentflare grant anyone read`), by a daemon holding the owner's key3132 --description <DESCRIPTION>33 What the project's listing says it is, at most 280 bytes (empty clears it)3435 --language <LANGUAGE>36 The project's main language on its listing, at most 32 bytes (empty clears it)3738 -h, --help39 Print help (see a summary with '-h')agentflare forget
1Stop hosting a project, leaving its files alone23Usage: agentflare forget [OPTIONS]45Options:6 --root <ROOT> The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)7 -h, --help Print helpagentflare key
1Manage peer keys23Usage: agentflare key <COMMAND>45Commands:6 new Create a peer key in the project through the daemon and print its peer id. With `--alias`, create the agent named so: its key, a grant of `write` and `message` on every path under that alias from the project's default peer; print `agentflare key new peer=<id> alias=<name>`. The agent edits the project's one tree. Run again for an alias the project holds, it makes nothing new and prints the same line. With `--session`, also bind that harness session to the peer, so a command run with `LVCS_SESSION` naming it acts as the peer7 release Release a harness session's binding: a binding lives as long as its session, whose end releases it; this releases one whose session died without its end, so its peer's alias can be bound again. Prints `agentflare key release session=<id>`; releasing what isn't bound prints the same8 help Print this message or the help of the given subcommand(s)910Options:11 -h, --help Print helpagentflare key new
1Create a peer key in the project through the daemon and print its peer id. With `--alias`, create the agent named so: its key, a grant of `write` and `message` on every path under that alias from the project's default peer; print `agentflare key new peer=<id> alias=<name>`. The agent edits the project's one tree. Run again for an alias the project holds, it makes nothing new and prints the same line. With `--session`, also bind that harness session to the peer, so a command run with `LVCS_SESSION` naming it acts as the peer23Usage: agentflare key new [OPTIONS]45Options:6 --root <ROOT> The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)7 --alias <ALIAS> The agent's alias: lowercase letters, digits, and `-`, starting with a letter8 --paths <PATHS> With `--alias`, the paths (gitignore syntax, repeatable) a new agent's grant covers in place of every path (`**`)9 --session <SESSION> A harness session's id to bind to the peer; a command run with `LVCS_SESSION` set to it acts as the peer10 -h, --help Print helpagentflare key release
1Release a harness session's binding: a binding lives as long as its session, whose end releases it; this releases one whose session died without its end, so its peer's alias can be bound again. Prints `agentflare key release session=<id>`; releasing what isn't bound prints the same23Usage: agentflare key release [OPTIONS] --session <SESSION>45Options:6 --root <ROOT> The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)7 --session <SESSION> The harness session whose binding to release8 -h, --help Print helpagentflare replay
1Check that the project's journal replays to the same state.23Outside any project, it checks the daemon's own journal.45Usage: agentflare replay [OPTIONS] --check67Options:8 --check9 Exit nonzero at the first entry whose replayed state differs1011 --root <ROOT>12 The project root (default: the current directory)1314 -h, --help15 Print help (see a summary with '-h')agentflare audit
1Check that every stored change is signed and authorized, and that no secret is stored.23Prints "audit ok" with the counts and exits 0, or prints the first violation and exits 1; exits 2 when the project can't be read.45Usage: agentflare audit [OPTIONS]67Options:8 --root <ROOT>9 The project root (default: the current directory)1011 -h, --help12 Print help (see a summary with '-h')agentflare migrate
1Bring a project's LVCS files to this version's format.23Run it while the daemon doesn't hold the project open. Prints one line per file it changed, or that there is nothing to migrate; exits 1 when a file is from a newer agentflare or can't be migrated.45Usage: agentflare migrate [OPTIONS]67Options:8 --root <ROOT>9 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)1011 -h, --help12 Print help (see a summary with '-h')agentflare status
1Show where you stand in this project, one line per item.23Outside any project, it lists every project the daemon hosts.45Usage: agentflare status [OPTIONS]67Options:8 --root <ROOT>9 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)1011 --as <PEER>12 The peer to show (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)1314 --clear-stray <FILE>15 Remove a stray copy `status` names, once its bytes are copied out: its file under `.lvcs/stray/`1617 -h, --help18 Print help (see a summary with '-h')agentflare explain
1Explain an error code, rule, recovery, or notification kind, or how a path is classified.23Works offline. With no value, lists every value it knows. Exits 2 when nothing matches.45Usage: agentflare explain [VALUE]67Arguments:8 [VALUE]9 The value to explain, matched case-insensitively; a code's number may be negative, as every one is1011Options:12 -h, --help13 Print help (see a summary with '-h')agentflare auth
1Pair devices such as the app in a browser, list them, and revoke them23Usage: agentflare auth <COMMAND>45Commands:6 login Pair a device (the app in a browser or on a phone): print a one-time link to open on it, wait for it to claim the pairing, and pair it once you confirm it shows the same code as the terminal. Prints `agentflare auth login device=<key> name=<name> grant=<grant id>`7 status List the devices you paired, one line each8 logout Revoke a paired device by its name or key; prints the revocation as one line of JSON9 help Print this message or the help of the given subcommand(s)1011Options:12 -h, --help Print helpagentflare auth login
1Pair a device (the app in a browser or on a phone): print a one-time link to open on it, wait for it to claim the pairing, and pair it once you confirm it shows the same code as the terminal. Prints `agentflare auth login device=<key> name=<name> grant=<grant id>`23Usage: agentflare auth login [OPTIONS]45Options:6 --name <NAME> The device's name among your own devices, which you never give another device of yours. Without it you are asked for one, defaulting to the device's own name, with a number when you named a device so before (taken as is when stdin is not a terminal)7 --write Let the device act as you, within your grants and its paths: message, reply, react, run gated actions, and propose plugin settings. Without it, the device only reads8 --read <GLOB> A path pattern the device may read (gitignore syntax); every path when none is given9 --no-browser Print the link without opening a browser10 --root <ROOT> The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)11 --as <PEER> The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)12 -h, --help Print helpagentflare auth status
1List the devices you paired, one line each23Usage: agentflare auth status [OPTIONS]45Options:6 --root <ROOT> The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)7 --as <PEER> The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)8 -h, --help Print helpagentflare auth logout
1Revoke a paired device by its name or key; prints the revocation as one line of JSON23Usage: agentflare auth logout [OPTIONS] <DEVICE>45Arguments:6 <DEVICE> The device's name among yours, or its key or a prefix of it; the owner names anyone's as `<person>:<name>`78Options:9 --root <ROOT> The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)10 --as <PEER> The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)11 -h, --help Print helpagentflare notify
1Show your notifications: what needs you, in LVCS's own words.23With nothing named, prints the unread ones grouped, with the commands to run, marking none read, and nothing when the filters show nothing. Naming ids or paths (or `--read` for all) prints those notifications whole and marks them read. `--wait` waits for the next one that needs you (an action failed on your changes, or a refused write), prints it, and exits; run it in the background. `--json` prints one line of JSON instead, for plugins.45Usage: agentflare notify [OPTIONS] [TARGETS]...67Arguments:8 [TARGETS]...9 Notification ids (or unique starts of them) and paths below the project root (`./<name>` forces a path) to read whole and mark read1011Options:12 --read13 Read every unread notification whole, and mark them read1415 --wait16 Wait for the next notification that needs you, then print it1718 --kind <KIND>19 With `--wait`, the `notification_kind`s to wait for (default: `action_failed`, `refused_write`)2021 --timeout <SECONDS>22 With `--wait`, seconds to wait (default ten minutes, at most an hour)2324 --fresh25 Print only when something arrived since the last listing2627 --json28 Print one line of JSON instead of text2930 --session <ID>31 The session to act for: the peer `agentflare key new --session` bound it to (default: `LVCS_SESSION`)3233 --mute <PEER>34 A sender to mute: none of its notifications are named or counted (repeatable)3536 --min-severity <SEVERITY>37 The least severity shown: `low` (the default), `normal`, or `high`3839 --root <ROOT>40 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)4142 --as <PEER>43 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)4445 -h, --help46 Print help (see a summary with '-h')agentflare add
1Save a file as it is on disk, sending its refused save again.23`--force` saves it even though the secret scan flags it, recording each flagged string in a signed allowlist entry with `--reason`. Prints the result as one line of JSON.45Usage: agentflare add [OPTIONS] <PATH>67Arguments:8 <PATH>9 The file's address1011Options:12 --force13 Save it even though the secret scan flags it: each flagged string gets a signed allowlist entry1415 --reason <WHY>16 Why the flagged text is no secret, recorded in the allowlist entry1718 --root <ROOT>19 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)2021 --as <PEER>22 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)2324 -h, --help25 Print help (see a summary with '-h')agentflare approve
1Approve changes to protected paths, at main's frontier when the daemon serves the request.23Only the paths named are approved: every other protected path waiting there keeps waiting for its own approval, so each peer approves its own saves. `--waiting` approves every protected path `agentflare status` lists as waiting, as it is then. Prints the result as one line of JSON, naming each approved path and who changed it.45Usage: agentflare approve [OPTIONS] [PATHS]...67Arguments:8 [PATHS]...9 The protected paths approved1011Options:12 --waiting13 Also approve every protected path waiting at main's frontier1415 --frontier <ID>16 Approve at this frontier id instead, refused unless it is still main's visible frontier (for scripts that pin one)1718 --unattested19 Approve before any change action attests the frontier, such as main's visible frontier `snapshot` names (owner only): the paths render in every tree at once, and gated actions still wait for `check`2021 --root <ROOT>22 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)2324 --as <PEER>25 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)2627 -h, --help28 Print help (see a summary with '-h')agentflare read
1Print a file's body as main holds it, or as a frontier does.23Only the body goes to stdout; `--heads` prints the heads read on stderr, as `agentflare write --base` takes them.45Usage: agentflare read [OPTIONS] <PATH>67Arguments:8 <PATH>9 The file's address1011Options:12 --at <FRONTIER>13 Read it as a frontier holds it: a frontier id, or a unique start of one a channel names (default: main)1415 --base <HEADS>16 Read it as main showed it at these heads, comma-separated as `--heads` prints them: an older version, which a stale save's notice names to bring back the lines it replaced1718 --heads19 Also print the heads read, comma-separated as `--base` takes them, on stderr2021 --root <ROOT>22 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)2324 --as <PEER>25 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)2627 -h, --help28 Print help (see a summary with '-h')agentflare write
1Save stdin as a file's new body, against the heads it was made from.23The change is diffed on whole lines against the text at `--base`, as a tree save is, and prints the new heads as one line of JSON.45Usage: agentflare write [OPTIONS] --base <HEADS> <PATH>67Arguments:8 <PATH>9 The file's address1011Options:12 --base <HEADS>13 The heads the new body was made from, as `lvcs read --heads` printed them. A file main doesn't hold yet has none: `--base ''` makes it1415 --root <ROOT>16 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)1718 --as <PEER>19 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)2021 -h, --help22 Print help (see a summary with '-h')agentflare diff
1Show how your main tree's files differ from main's23Usage: agentflare diff [OPTIONS] [PATHS]...45Arguments:6 [PATHS]... Addresses, or directories ending in `/`, to compare (default: every file main holds)78Options:9 --root <ROOT> The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)10 --as <PEER> The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)11 -h, --help Print helpagentflare mv
1Rename a file, or a directory's files, keeping their history and blame23Usage: agentflare mv [OPTIONS] <FROM> <TO>45Arguments:6 <FROM> The address of the file, or of the directory whose files move7 <TO> Its new address89Options:10 --root <ROOT> The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)11 --as <PEER> The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)12 -h, --help Print helpagentflare rm
1Delete files, against the heads they were read at23Usage: agentflare rm [OPTIONS] <PATHS>...45Arguments:6 <PATHS>... The files' addresses78Options:9 --root <ROOT> The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)10 --as <PEER> The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)11 -h, --help Print helpagentflare restore
1Write main's version over your main tree's files, discarding their unsaved or refused bytes.23The recovery for a stale or refused save: restore, then redo the change on main's text.45Usage: agentflare restore [OPTIONS] <PATHS>...67Arguments:8 <PATHS>...9 The files' addresses1011Options:12 --root <ROOT>13 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)1415 --as <PEER>16 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)1718 -h, --help19 Print help (see a summary with '-h')agentflare grant
1Let a peer read, write, or more on some paths.23Prints the grant as one line of JSON. `agentflare revoke` takes it back.45Usage: agentflare grant [OPTIONS] <GRANTEE> <CAPABILITIES>...67Arguments:8 <GRANTEE>9 The peer: its id, its alias, or a prefix of an id this project knows, as `agentflare status` and `agentflare key new` show it (a peer from another node with no grant yet goes by its whole id); or `anyone`, with read only, which makes the project public: `agentflare status` outside it then prints the link anyone reads it at1011 <CAPABILITIES>...12 What it may do: read, write, approve, delegate, or a plugin's verb, such as message, or channel.move with --paths naming the channels it moves1314Options:15 --paths <PATHS>16 A path pattern it applies to (gitignore syntax, repeatable); every path when none is given1718 --alias <ALIAS>19 The name it is shown by, which stays its for the life of the project2021 --plugin <PLUGIN>22 Make the peer an instance of this recorded plugin: a node's own key for it. The owner's grant so makes it trusted as the plugin, for a privileged role such as a runner's2324 --ttl <TTL>25 How long each window of the grant lasts, such as 900, 15m, 2h, or 1d (at least 10 s; default: no expiry). Your daemon renews it every half window while it runs, so a node that is offline when you revoke the grant stops honouring it at most one window after it last synced; without one, such a node honours it until it syncs2627 --root <ROOT>28 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)2930 --as <PEER>31 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)3233 -h, --help34 Print help (see a summary with '-h')agentflare plugin
1Install, list, upgrade, and remove plugins.23A plugin adds one command, `agentflare <command>`, and has no permissions but those its plugin.toml declares.45Usage: agentflare plugin [OPTIONS] <COMMAND>67Commands:8 install Install a plugin into this project's store, or with --global the node's: from its directory (holding its plugin.toml), or from an install source (a release index URL, or github:<owner>/<repo>, each with an optional @x.y.z and #key=<key>), whose signed release is checked first9 list List the installed plugins, one line of JSON10 upgrade Upgrade an installed plugin to the one a source gives11 remove Remove an installed plugin: revoke its grants and drop its command12 enable Enable a plugin the node's store holds in this project: its key and exactly the grants its manifest declares. Prints the result as one line of JSON13 disable Disable a plugin in this project: revoke its grants and stop it14 resolve Resolve plugin install sources into a fixed, checked set, without a daemon (discussion:owner/768 points 18 to 20)15 help Print this message or the help of the given subcommand(s)1617Options:18 --root <ROOT>19 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)2021 --as <PEER>22 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)2324 -h, --help25 Print help (see a summary with '-h')agentflare plugin install
1Install a plugin into this project's store, or with --global the node's: from its directory (holding its plugin.toml), or from an install source (a release index URL, or github:<owner>/<repo>, each with an optional @x.y.z and #key=<key>), whose signed release is checked first.23With --enable it is also enabled here: its key, exactly the grants its manifest declares, and its command. Prints the result as one line of JSON.45Usage: agentflare plugin install [OPTIONS] <SOURCE>67Arguments:8 <SOURCE>9 The plugin's directory, a bundled plugin's name, or an install source1011Options:12 --global13 Put it on the node, for every project this daemon hosts1415 --enable16 Also enable it in this project1718 --binary <BINARY>19 Its built binary, when it isn't the manifest's `binary` in the directory (one built into a cargo target directory elsewhere)2021 --allow-remote <ROLE>22 A remote role its manifest declares that it may run as off this machine (repeatable), allowed at its enable; without one it reaches the daemon only over this machine's socket2324 -h, --help25 Print help (see a summary with '-h')agentflare plugin list
1List the installed plugins, one line of JSON23Usage: agentflare plugin list45Options:6 -h, --help Print helpagentflare plugin upgrade
1Upgrade an installed plugin to the one a source gives.23It runs the new version under its key, with what the new manifest declares. Without a source, a bundled plugin's own directory. Prints the result as one line of JSON.45Usage: agentflare plugin upgrade [OPTIONS] <NAME> [SOURCE]67Arguments:8 <NAME>9 The plugin's name1011 [SOURCE]12 The new version's directory or install source1314Options:15 --global16 Upgrade the node's install, for every project this daemon hosts1718 -h, --help19 Print help (see a summary with '-h')agentflare plugin remove
1Remove an installed plugin: revoke its grants and drop its command.23Its documents stay. Prints the result as one line of JSON.45Usage: agentflare plugin remove <NAME>67Arguments:8 <NAME>9 The plugin's name1011Options:12 -h, --help13 Print help (see a summary with '-h')agentflare plugin enable
1Enable a plugin the node's store holds in this project: its key and exactly the grants its manifest declares. Prints the result as one line of JSON23Usage: agentflare plugin enable <NAME>45Arguments:6 <NAME> The plugin's name78Options:9 -h, --help Print helpagentflare plugin disable
1Disable a plugin in this project: revoke its grants and stop it.23Its key and documents stay. Prints the result as one line of JSON.45Usage: agentflare plugin disable <NAME>67Arguments:8 <NAME>9 The plugin's name1011Options:12 -h, --help13 Print help (see a summary with '-h')agentflare plugin resolve
1Resolve plugin install sources into a fixed, checked set, without a daemon (discussion:owner/768 points 18 to 20).23Writes resolved.json, each target's plugins/ tree, and each target's bundle-<target>.tar.zst, as the daemon's release embeds it.45Usage: agentflare plugin resolve --out <OUT> --daemon <DAEMON> <SOURCE>...67Arguments:8 <SOURCE>...9 The plugin sources: <https url>[@x.y.z]#key=<key> or github:<owner>/<repo>[@x.y.z]#key=<key>, or dir:<absolute path>[@x.y.z]#key=<key> (a directory laid out as a release index), <key> the Ed25519 public key (ID_ENCODING) its releases are signed with, or a key constant of lvcs_vocab::ids by name (PLUGIN_SIGNING_KEY). PIN_<NAME>=<x.y.z> holds an index source that names no version at that version1011Options:12 --out <OUT>13 The directory to write: resolved.json, <target>/plugins/<name>/, bundle-<target>.tar.zst, and SHA256SUMS. An earlier resolve's output there is replaced; any other non-empty directory is refused1415 --daemon <DAEMON>16 The daemon version the set is fixed for, resolved.json's `daemon`1718 -h, --help19 Print help (see a summary with '-h')agentflare revoke
1Take back a grant, and every renewal of it.23Prints the result as one line of JSON.45Usage: agentflare revoke [OPTIONS] <GRANT>67Arguments:8 <GRANT>9 The grant: its id, from `grant`'s result, or the start of one; or the peer holding it: its id, alias, or a prefix of its id1011Options:12 --root <ROOT>13 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)1415 --as <PEER>16 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)1718 -h, --help19 Print help (see a summary with '-h')agentflare purge
1Purge deleted files' documents from the project, as its owner.23Each target is a removed file's last path (every removed file at it or under it) or a file id. Final: every honest node drops the content and never serves or syncs it again; copies already made are not recalled. Prints the result as one line of JSON.45With --unplaced, each target is the file id of a document the namespace never placed, which `agentflare audit` reports as not placed after a namespace change was set aside.67Usage: agentflare purge [OPTIONS] <TARGETS>...89Arguments:10 <TARGETS>...11 Removed files' paths or file ids1213Options:14 --unplaced15 Purge documents the namespace never placed, named by file id1617 --root <ROOT>18 The project root (default: the nearest ancestor of the current directory holding `.lvcs/`)1920 --as <PEER>21 The peer to act as (default: `LVCS_PEER`, else the one key bound to this OS user, else, as the daemon's own user, the owner)2223 -h, --help24 Print help (see a summary with '-h')agentflare update
1Update lvcs to the latest signed release and restart the daemon.23Keeps the old binary as agentflare.prev. The daemon also checks daily and, with auto-update on (the default), updates itself.45Usage: agentflare update [OPTIONS]67Options:8 --check9 Only say whether a release is available; change nothing1011 --auto <on|off>12 Turn auto-update on, or off (the daemon then only notifies)1314 Possible values:15 - on: Auto-update on16 - off: Auto-update off: notify only1718 --rollback19 Put back the binary the last update replaced, and hold the version rolled back from until the next `agentflare update`2021 --channel <release|edge>22 Follow signed releases, or the edge builds of each frontier the gate passed, staggered by slot and each tried before it replaces this binary (`release` or `edge`)2324 Possible values:25 - release: Signed releases (293)26 - edge: The dev-signed builds of each frontier the gate passed2728 --url <URL>29 The edge channel's manifest URL3031 --slot <SLOT>32 This node's edge slot: slot n applies a build n times UPDATE_EDGE_STAGGER_MS after it was built3334 -h, --help35 Print help (see a summary with '-h')