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

Every agentflare command and flag, as agentflare <command> --help prints it.

agentflare

texton main
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

texton main
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

texton main
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

texton main
1Stop the daemon and remove its service, leaving every project alone23Usage: agentflare uninstall45Options:6  -h, --help  Print help

agentflare join

texton main
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

texton main
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

texton main
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

texton main
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 help

agentflare key

texton main
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 help

agentflare key new

texton main
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 help

agentflare key release

texton main
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 help

agentflare replay

texton main
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

texton main
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

texton main
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

texton main
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

texton main
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

texton main
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 help

agentflare auth login

texton main
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 help

agentflare auth status

texton main
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 help

agentflare auth logout

texton main
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 help

agentflare notify

texton main
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

texton main
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

texton main
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

texton main
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

texton main
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

texton main
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 help

agentflare mv

texton main
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 help

agentflare rm

texton main
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 help

agentflare restore

texton main
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

texton main
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

texton main
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

texton main
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

texton main
1List the installed plugins, one line of JSON23Usage: agentflare plugin list45Options:6  -h, --help  Print help

agentflare plugin upgrade

texton main
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

texton main
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

texton main
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 help

agentflare plugin disable

texton main
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

texton main
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

texton main
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

texton main
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

texton main
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')