Artifact 2f3fbd8a8d08729b4fef987d95442e276f9528b01a6629daa30324ffb945a9e7:
- File
docs/site/content/docs/reference/cli/_index.md
— part of check-in
[d7fd910ffc]
at
2026-10-23 21:12:43
on branch main
— docs: generate the site's data, CLI reference and llms.txt from the code
tools/docsgen/engine records one check-in as an artifact, as its derived rows and as the cards of a pull, from a real engine run with fixed inputs. tools/docsgen/conformance turns TestCoverage's report into per-draft and per-requirement data. scripts/gen-cli-docs.sh writes one page per command group from the libfossil binary's --help. gen-llms-txt.sh and check-llms-txt.sh are ported from dagnats, and sync-version.sh now takes the highest release tag and writes the go.mod version too.
scripts/check-docs-generated.sh regenerates everything into a scratch dir and fails on any difference; make docs-check and the test-docs CI job run it. (user: [email protected], size: 10294) [annotate] [blame] [check-ins using] [more...]
--- title: CLI weight: 20 generated: true --- <!-- Generated by scripts/gen-cli-docs.sh from the libfossil --help output. Do not edit; change the help text in cli/ and run make docs-gen. --> The `libfossil` command, one page per command group. Every page is the output of the binary's own `--help`. ```text Usage: libfossil <command> [flags] Fossil-compatible repository tool (pure Go) Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output Commands: repo new [<path>] [flags] Create a new repository repo clone [<url> [<path>]] [flags] Clone a remote repository repo ci --message=STRING [<files> ...] [flags] Checkin file changes repo co [<version>] [flags] Checkout a version repo ls [<version>] [flags] List files in a version repo timeline [flags] Show repository history repo snapshot --message=STRING --path=STRING [flags] Commit a file's bytes onto trunk, no checkout needed repo log --path=STRING [flags] Show the check-ins that changed a path repo cat <artifact> [flags] Output artifact content repo info Repository statistics repo hash <files> ... [flags] Hash files (SHA1 or SHA3) repo delta create <source> <target> [flags] Create a delta between two files repo delta apply <source> <delta> [flags] Apply a delta to a source file repo config ls List all config entries repo config get <key> Get a config value repo config set <key> <value> Set a config value repo query <sql> Execute SQL against repository repo verify [flags] Verify repository integrity repo resolve <name> Resolve symbolic name to UUID repo extract [<files> ...] [flags] Extract files from a version repo wiki ls List wiki pages repo wiki export <page> [flags] Export a wiki page repo tag ls [<version>] List tags on an artifact repo tag add <tag> [<value>] [flags] Add a tag to an artifact repo open [<dir>] [flags] Open a checkout in a directory repo status [flags] Show working directory changes repo add <files> ... [flags] Stage files for addition repo rm <files> ... [flags] Stage files for removal repo rename <from> <to> [flags] Rename a tracked file repo revert [<files> ...] [flags] Undo staging changes repo diff [<version> [<to> [<path>]]] [flags] Show changes vs a version repo merge <version> [flags] Merge a divergent version repo conflicts ls [flags] List all conflicts repo conflicts show <file> [flags] Show all versions of a conflicted file repo conflicts pick <file> [flags] Resolve by picking one version repo conflicts merge <file> [flags] Resolve by re-merging with a different strategy repo conflicts extract <file> [flags] Extract all versions to disk for manual editing repo mark-resolved <file> [flags] Mark a conflict as resolved repo undo [flags] Undo last operation repo redo [flags] Redo undone operation repo stash save [flags] Stash working changes repo stash pop [flags] Apply top stash and drop it repo stash apply [<id>] [flags] Apply stash without dropping repo stash ls List stash entries repo stash drop <id> Remove stash entry repo stash clear Remove all stash entries repo bisect good [<version>] [flags] Mark version as good repo bisect bad [<version>] [flags] Mark version as bad repo bisect next [flags] Check out midpoint version repo bisect skip [<version>] [flags] Skip current version repo bisect reset [flags] Clear bisect state repo bisect ls [flags] Show bisect path repo bisect status [flags] Show bisect state repo annotate <file> [flags] Annotate file lines with version history repo blame <file> [flags] Alias for annotate repo branch ls [flags] List branches repo branch new <name> [flags] Create new branch repo branch close <name> [flags] Close a branch repo uv ls List unversioned files repo uv put <name> <file> Add or update an unversioned file repo uv get <name> [flags] Retrieve an unversioned file repo uv delete <name> Delete an unversioned file (creates tombstone) repo schema add --columns=STRING <name> [flags] Register a new synced table repo schema list List registered synced tables repo schema show <name> Show table schema details repo schema remove <name> Remove a synced table registration repo user add --cap=STRING <login> Create a new user repo user list List all users repo user update --cap=STRING <login> Update user capabilities repo user rm <login> Delete a user repo user passwd <login> Reset user password repo invite --cap=STRING <login> [flags] Generate invite token for a user repo serve [flags] Serve repository over HTTP for sync/clone repo submanifests enable [flags] Write new check-ins as sub-manifest trees repo submanifests retune --k=INT Re-pin the partition parameter for later commits repo submanifests disable Write new check-ins as flat manifests again repo submanifests status Show the sub-manifest settings and whether trees exist repo cone show [flags] List the cone's members ("dense" when there is none) repo cone add <paths> ... [flags] Widen the cone, or with --not carve paths out of it repo cone remove <paths> ... [flags] Remove members of either polarity repo cone set <paths> ... [flags] Replace the cone repo cone dense [flags] Drop the cone and materialize every file repo cone test <paths> ... [flags] Classify paths against the cone and name the deciding member repo cone store [<paths> ...] [flags] Show or replace the repository's store cone, fetching what widening covers repo cone deepen <checkin> [flags] Move the store's horizon down to reach a check-in, fetching the history it keeps repo cone compact Drop held blobs the store cone elides (irreversible locally) repo cone cost <checkin> Report what each horizon rule would hold at a check-in, from this repository version [flags] Print version information Run "libfossil <command> --help" for more information on a command. ``` ## Command groups - [`libfossil repo new`](/docs/reference/cli/repo-new/): Create a new repository - [`libfossil repo clone`](/docs/reference/cli/repo-clone/): Clone a remote repository - [`libfossil repo ci`](/docs/reference/cli/repo-ci/): Checkin file changes - [`libfossil repo co`](/docs/reference/cli/repo-co/): Checkout a version - [`libfossil repo ls`](/docs/reference/cli/repo-ls/): List files in a version - [`libfossil repo timeline`](/docs/reference/cli/repo-timeline/): Show repository history - [`libfossil repo snapshot`](/docs/reference/cli/repo-snapshot/): Commit a file's bytes onto trunk, no checkout needed - [`libfossil repo log`](/docs/reference/cli/repo-log/): Show the check-ins that changed a path - [`libfossil repo cat`](/docs/reference/cli/repo-cat/): Output artifact content - [`libfossil repo info`](/docs/reference/cli/repo-info/): Repository statistics - [`libfossil repo hash`](/docs/reference/cli/repo-hash/): Hash files (SHA1 or SHA3) - [`libfossil repo delta`](/docs/reference/cli/repo-delta/): Delta create/apply operations - [`libfossil repo config`](/docs/reference/cli/repo-config/): Repository configuration - [`libfossil repo query`](/docs/reference/cli/repo-query/): Execute SQL against repository - [`libfossil repo verify`](/docs/reference/cli/repo-verify/): Verify repository integrity - [`libfossil repo resolve`](/docs/reference/cli/repo-resolve/): Resolve symbolic name to UUID - [`libfossil repo extract`](/docs/reference/cli/repo-extract/): Extract files from a version - [`libfossil repo wiki`](/docs/reference/cli/repo-wiki/): Wiki page operations - [`libfossil repo tag`](/docs/reference/cli/repo-tag/): Tag operations - [`libfossil repo open`](/docs/reference/cli/repo-open/): Open a checkout in a directory - [`libfossil repo status`](/docs/reference/cli/repo-status/): Show working directory changes - [`libfossil repo add`](/docs/reference/cli/repo-add/): Stage files for addition - [`libfossil repo rm`](/docs/reference/cli/repo-rm/): Stage files for removal - [`libfossil repo rename`](/docs/reference/cli/repo-rename/): Rename a tracked file - [`libfossil repo revert`](/docs/reference/cli/repo-revert/): Undo staging changes - [`libfossil repo diff`](/docs/reference/cli/repo-diff/): Show changes vs a version - [`libfossil repo merge`](/docs/reference/cli/repo-merge/): Merge a divergent version - [`libfossil repo conflicts`](/docs/reference/cli/repo-conflicts/): List/manage unresolved conflicts - [`libfossil repo mark-resolved`](/docs/reference/cli/repo-mark-resolved/): Mark a conflict as resolved - [`libfossil repo undo`](/docs/reference/cli/repo-undo/): Undo last operation - [`libfossil repo redo`](/docs/reference/cli/repo-redo/): Redo undone operation - [`libfossil repo stash`](/docs/reference/cli/repo-stash/): Stash working changes - [`libfossil repo bisect`](/docs/reference/cli/repo-bisect/): Binary search for bugs - [`libfossil repo annotate`](/docs/reference/cli/repo-annotate/): Annotate file lines with version history - [`libfossil repo blame`](/docs/reference/cli/repo-blame/): Alias for annotate - [`libfossil repo branch`](/docs/reference/cli/repo-branch/): Branch operations - [`libfossil repo uv`](/docs/reference/cli/repo-uv/): Unversioned file operations - [`libfossil repo schema`](/docs/reference/cli/repo-schema/): Synced table schema operations - [`libfossil repo user`](/docs/reference/cli/repo-user/): User management - [`libfossil repo invite`](/docs/reference/cli/repo-invite/): Generate invite token for a user - [`libfossil repo serve`](/docs/reference/cli/repo-serve/): Serve repository over HTTP for sync/clone - [`libfossil repo submanifests`](/docs/reference/cli/repo-submanifests/): Sub-manifest tree settings - [`libfossil repo cone`](/docs/reference/cli/repo-cone/): Show or edit a checkout's sparse cone - [`libfossil version`](/docs/reference/cli/version/): Print version information