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.
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: Create a new repositorylibfossil repo clone: Clone a remote repositorylibfossil repo ci: Checkin file changeslibfossil repo co: Checkout a versionlibfossil repo ls: List files in a versionlibfossil repo timeline: Show repository historylibfossil repo snapshot: Commit a file's bytes onto trunk, no checkout neededlibfossil repo log: Show the check-ins that changed a pathlibfossil repo cat: Output artifact contentlibfossil repo info: Repository statisticslibfossil repo hash: Hash files (SHA1 or SHA3)libfossil repo delta: Delta create/apply operationslibfossil repo config: Repository configurationlibfossil repo query: Execute SQL against repositorylibfossil repo verify: Verify repository integritylibfossil repo resolve: Resolve symbolic name to UUIDlibfossil repo extract: Extract files from a versionlibfossil repo wiki: Wiki page operationslibfossil repo tag: Tag operationslibfossil repo open: Open a checkout in a directorylibfossil repo status: Show working directory changeslibfossil repo add: Stage files for additionlibfossil repo rm: Stage files for removallibfossil repo rename: Rename a tracked filelibfossil repo revert: Undo staging changeslibfossil repo diff: Show changes vs a versionlibfossil repo merge: Merge a divergent versionlibfossil repo conflicts: List/manage unresolved conflictslibfossil repo mark-resolved: Mark a conflict as resolvedlibfossil repo undo: Undo last operationlibfossil repo redo: Redo undone operationlibfossil repo stash: Stash working changeslibfossil repo bisect: Binary search for bugslibfossil repo annotate: Annotate file lines with version historylibfossil repo blame: Alias for annotatelibfossil repo branch: Branch operationslibfossil repo uv: Unversioned file operationslibfossil repo schema: Synced table schema operationslibfossil repo user: User managementlibfossil repo invite: Generate invite token for a userlibfossil repo serve: Serve repository over HTTP for sync/clonelibfossil repo submanifests: Sub-manifest tree settingslibfossil repo cone: Show or edit a checkout's sparse conelibfossil version: Print version information