Artifact 919468c3c8a2691aa0425c97a31bc1f68b5ea2c7d908afdbf6abba4d4eb1483f:
- File
docs/site/content/docs/reference/cli/repo-cone.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: 8561) [annotate] [blame] [check-ins using] [more...]
--- title: 'repo cone' weight: 430 generated: true description: 'Show or edit a checkout''s sparse cone' --- <!-- 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. --> ```text Usage: libfossil repo cone <command> Show or edit a checkout's sparse cone Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output Commands: 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 ``` ## repo cone show ```text Usage: libfossil repo cone show [flags] List the cone's members ("dense" when there is none) Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output -d, --dir="." Checkout directory ``` ## repo cone add ```text Usage: libfossil repo cone add <paths> ... [flags] Widen the cone, or with --not carve paths out of it Arguments: <paths> ... Paths to add Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output --remote=STRING Required-content peer URL (default: saved last-sync-url) --sync-user=STRING Required-content authentication user --sync-pass=STRING Required-content password (never saved) --sync-private Allow recovery of private required artifacts --timeout=10m Required-content deadline; 0 disables it --not Add the paths as exclusions -d, --dir="." Checkout directory ``` ## repo cone remove ```text Usage: libfossil repo cone remove <paths> ... [flags] Remove members of either polarity Arguments: <paths> ... Members to remove Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output --remote=STRING Required-content peer URL (default: saved last-sync-url) --sync-user=STRING Required-content authentication user --sync-pass=STRING Required-content password (never saved) --sync-private Allow recovery of private required artifacts --timeout=10m Required-content deadline; 0 disables it -d, --dir="." Checkout directory ``` ## repo cone set ```text Usage: libfossil repo cone set <paths> ... [flags] Replace the cone Arguments: <paths> ... Inclusion members Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output --remote=STRING Required-content peer URL (default: saved last-sync-url) --sync-user=STRING Required-content authentication user --sync-pass=STRING Required-content password (never saved) --sync-private Allow recovery of private required artifacts --timeout=10m Required-content deadline; 0 disables it --not=NOT,... Exclusion members (repeatable) -d, --dir="." Checkout directory ``` ## repo cone dense ```text Usage: libfossil repo cone dense [flags] Drop the cone and materialize every file Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output --remote=STRING Required-content peer URL (default: saved last-sync-url) --sync-user=STRING Required-content authentication user --sync-pass=STRING Required-content password (never saved) --sync-private Allow recovery of private required artifacts --timeout=10m Required-content deadline; 0 disables it -d, --dir="." Checkout directory ``` ## repo cone test ```text Usage: libfossil repo cone test <paths> ... [flags] Classify paths against the cone and name the deciding member Arguments: <paths> ... Paths to classify Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output -q, --quiet Print nothing; report through the exit status only -d, --dir="." Checkout directory ``` ## repo cone store ```text Usage: libfossil repo cone store [<paths> ...] [flags] Show or replace the repository's store cone, fetching what widening covers Arguments: [<paths> ...] Inclusion members; none shows the store cone Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output --remote=STRING Required-content peer URL (default: saved last-sync-url) --sync-user=STRING Required-content authentication user --sync-pass=STRING Required-content password (never saved) --sync-private Allow recovery of private required artifacts --timeout=10m Required-content deadline; 0 disables it --not=NOT,... Exclusion members (repeatable) --dense Drop the store cone, fetching everything it elided --horizon=STRING Elide blobs below this check-in (name, branch or hash prefix), fetching what a deeper horizon keeps; 'repo cone cost' shows what each rule would hold --leaves With --horizon, also hold every open leaf's ancestry back to the check-in, for merging across live branches offline; costly: on a repository with old unmerged branches that is nearly the whole history --structural With --horizon, also elide the manifests below the check-in; the next pull fetches the origin's seed --no-horizon Drop the horizon, keeping the path members, and fetch what it elided ``` ## repo cone deepen ```text Usage: libfossil repo cone deepen <checkin> [flags] Move the store's horizon down to reach a check-in, fetching the history it keeps Arguments: <checkin> Check-in to reach: a full hash, which may lie below the horizon, or a name Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output --remote=STRING Required-content peer URL (default: saved last-sync-url) --sync-user=STRING Required-content authentication user --sync-pass=STRING Required-content password (never saved) --sync-private Allow recovery of private required artifacts --timeout=10m Required-content deadline; 0 disables it ``` ## repo cone compact ```text Usage: libfossil repo cone compact Drop held blobs the store cone elides (irreversible locally) Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output ``` ## repo cone cost ```text Usage: libfossil repo cone cost <checkin> Report what each horizon rule would hold at a check-in, from this repository Arguments: <checkin> Check-in to place the horizon at: a name, branch or hash prefix Flags: -h, --help Show context-sensitive help. -R, --repo=STRING Path to repository file -v, --verbose Verbose output ```