[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6},"actionData","errors","routes/docs",{"_7":8,"_9":10,"_11":12,"_13":14,"_15":16},"path","commands/path.mdx","url","/docs/commands/path","markdownUrl","/llms.mdx/docs/commands/path/content.md","sourceFile","DOCS.md","pageTree",{"_17":18,"_19":20},"$fumadocs_loader","page-tree","data",{"_21":22,"_23":24,"_25":22,"_26":27,"_28":-7,"_29":30,"_31":32},"type","root","$ref",{"_37":38,"_39":265},"$id","name","gitto","description","children",[40,41,42,43,44,45,46,47,48],"fallback",{"_21":22,"_23":33,"_25":34,"_26":35,"_28":-7,"_29":36},{"_37":38,"_39":-7},"fallback:root","Docs",[],"folder","","meta",{"_25":261,"_21":60,"_26":27,"_28":262,"_57":263,"_9":264,"_23":261},{"_25":256,"_21":60,"_26":257,"_28":258,"_57":259,"_9":260,"_23":256},{"_25":251,"_21":60,"_26":252,"_28":253,"_57":254,"_9":255,"_23":251},{"_25":246,"_21":60,"_26":247,"_28":248,"_57":249,"_9":250,"_23":246},{"_21":37,"_26":216,"_22":-7,"_50":-7,"_28":-7,"_51":-7,"_29":217,"_25":218,"_23":219,"_55":220,"_57":221},{"_21":37,"_26":159,"_22":-7,"_50":-7,"_28":-7,"_51":-7,"_29":160,"_25":161,"_23":162,"_55":163,"_57":164},{"_21":37,"_26":134,"_22":-7,"_50":-7,"_28":-7,"_51":-7,"_29":135,"_25":136,"_23":137,"_55":138,"_57":139},{"_21":37,"_26":79,"_22":-7,"_50":-7,"_28":-7,"_51":-7,"_29":80,"_25":81,"_23":82,"_55":83,"_57":84},{"_21":37,"_26":49,"_22":-7,"_50":-7,"_28":-7,"_51":-7,"_29":52,"_25":53,"_23":54,"_55":56,"_57":58},"Caveats","defaultOpen","collapsible",[64,65,66],"caveats",{"_37":53,"_39":63},"index",{"_25":59,"_21":60,"_26":49,"_28":61,"_57":58,"_9":62,"_23":59},"icon","","caveats/index.mdx","page","What it cannot see, and what a copy cannot carry.","/docs/caveats","caveats/meta.json",{"_25":75,"_21":60,"_26":76,"_28":77,"_57":-7,"_9":78,"_23":75},{"_25":71,"_21":60,"_26":72,"_28":73,"_57":-7,"_9":74,"_23":71},{"_25":67,"_21":60,"_26":68,"_28":69,"_57":-7,"_9":70,"_23":67},"caveats/which-filesystems-can-share-blocks.mdx","Which filesystems can share blocks","A filesystem missing from this table is measured like any other, so the answer comes from the probe.","/docs/caveats/which-filesystems-can-share-blocks","caveats/what-a-clone-cannot-carry.mdx","What a clone cannot carry","Absolute paths inside files that `doctor` does not know the format of. A compiled artifact with a build path baked into it, a database with a stored data directory, a lockfile that recorded where it ran. They are copied faithfully and they still name the original.","/docs/caveats/what-a-clone-cannot-carry","caveats/what-doctor-cannot-see.mdx","What doctor cannot see","Only git's own records and two file formats that write their own path. Anything else that points into a directory, including a line in a shell profile or a process whose working directory is inside it, is invisible to the report.","/docs/caveats/what-doctor-cannot-see","Q&A",[89,90,91,92,93,94,95,96,97],"questions",{"_37":81,"_39":88},{"_25":85,"_21":60,"_26":79,"_28":86,"_57":84,"_9":87,"_23":85},"","questions/index.mdx","Short answers to what people ask before they install it.","/docs/questions","questions/meta.json",{"_25":130,"_21":60,"_26":131,"_28":132,"_57":-7,"_9":133,"_23":130},{"_25":126,"_21":60,"_26":127,"_28":128,"_57":-7,"_9":129,"_23":126},{"_25":122,"_21":60,"_26":123,"_28":124,"_57":-7,"_9":125,"_23":122},{"_25":118,"_21":60,"_26":119,"_28":120,"_57":-7,"_9":121,"_23":118},{"_25":114,"_21":60,"_26":115,"_28":116,"_57":-7,"_9":117,"_23":114},{"_25":110,"_21":60,"_26":111,"_28":112,"_57":-7,"_9":113,"_23":110},{"_25":106,"_21":60,"_26":107,"_28":108,"_57":-7,"_9":109,"_23":106},{"_25":102,"_21":60,"_26":103,"_28":104,"_57":-7,"_9":105,"_23":102},{"_25":98,"_21":60,"_26":99,"_28":100,"_57":-7,"_9":101,"_23":98},"questions/versus-git-clone.mdx","How is this different from a fresh git clone?","A clone from a remote downloads the history again and gives you a checkout with nothing built in it. This copies the local directory, including everything git does not track, and pays for neither the download nor the build.","/docs/questions/versus-git-clone","questions/remotes.mdx","Does it need GitHub, or a remote at all?","`new` runs `git fetch` before it resolves the default base, so a repository with no remote needs an explicit base, such as `gitto new auth-fix HEAD`. Nothing else in the tool reaches the network.","/docs/questions/remotes","questions/moving-the-canonical.mdx","What if the canonical moves?","Every clone records the path it came from, so they report that the canonical is missing. Move it back, or make fresh clones from its new location.","/docs/questions/moving-the-canonical","questions/undo.mdx","How do I undo one?","`gitto remove `, which refuses while anything would be lost. There is nothing else to clean up: a clone is one directory, and removing it leaves the canonical untouched.","/docs/questions/undo","questions/keeping-current.mdx","How do I keep the canonical current?","`gitto sync` fetches, fast-forwards it, and runs `.gitto-refresh` if the project carries one. `gitto list` prints how far behind the canonical is on its first line, so the drift is visible before it costs you anything.","/docs/questions/keeping-current","questions/from-inside-a-clone.mdx","Can I run it from inside a clone?","Yes, and what you get is another clone of the same canonical. Each clone records where it came from in a `.gitto` file, so every command resolves the canonical from wherever you are standing, and a chain of clones of clones cannot form.","/docs/questions/from-inside-a-clone","questions/ext4.mdx","What happens on ext4?","It refuses and says why. ext4 has no way to share blocks between two files, so every copy would cost the full size.","/docs/questions/ext4","questions/linux.mdx","Does this work on Linux?","The script is POSIX and uses no BSD-only spelling, so the reflink path calls `cp --reflink=always` and reads free space through `df -k`. It has not been run on Linux. The probe measures what a copy actually consumed, so a filesystem it guesses wrong about refuses the clone rather than making a full copy of 13 GB.","/docs/questions/linux","questions/worktree.mdx","Why not use a worktree?","Use one when the tracked files are all you need. A worktree shares one repository, which is why it costs almost nothing and why it carries almost nothing: no dependencies, no build output, no initialised submodules, and a branch that no second worktree may check out.","/docs/questions/worktree","How it works",[144,145,146],"how-it-works",{"_37":136,"_39":143},{"_25":140,"_21":60,"_26":134,"_28":141,"_57":139,"_9":142,"_23":140},"","how-it-works/index.mdx","Copy, re-address, measure: what a run does in order.","/docs/how-it-works","how-it-works/meta.json",{"_25":155,"_21":60,"_26":156,"_28":157,"_57":-7,"_9":158,"_23":155},{"_25":151,"_21":60,"_26":152,"_28":153,"_57":-7,"_9":154,"_23":151},{"_25":147,"_21":60,"_26":148,"_28":149,"_57":-7,"_9":150,"_23":147},"how-it-works/measuring-the-filesystem.mdx","Measuring the filesystem","Before any of that, `gitto` writes a 32 MB probe file, clones it with the system call, and compares free space before and after. A copy that consumed the probe's own size was a full copy, whatever the exit status said.","/docs/how-it-works/measuring-the-filesystem","how-it-works/re-addressing.mdx","Re-addressing","Then it walks what the copy now claims about itself and applies one of three dispositions.","/docs/how-it-works/re-addressing","how-it-works/copying.mdx","Copying","`gitto` copies the whole directory with the filesystem's clone call, so the copy shares its blocks with the canonical and costs only the metadata. Nothing is excluded and nothing is rebuilt: `.git`, the submodules, `node_modules`, the build directory and the untracked local files all come along.","/docs/how-it-works/copying","Commands",[169,170,171,172,173,174,175,176,177,178],"commands",{"_37":161,"_39":168},{"_25":165,"_21":60,"_26":159,"_28":166,"_57":164,"_9":167,"_23":165},"","commands/index.mdx","Four commands, what each one takes, and what each one refuses.","/docs/commands","commands/meta.json",{"_25":212,"_21":60,"_26":213,"_28":214,"_57":-7,"_9":215,"_23":212},{"_25":208,"_21":60,"_26":209,"_28":210,"_57":-7,"_9":211,"_23":208},{"_25":204,"_21":60,"_26":205,"_28":206,"_57":-7,"_9":207,"_23":204},{"_25":200,"_21":60,"_26":201,"_28":202,"_57":-7,"_9":203,"_23":200},{"_25":196,"_21":60,"_26":197,"_28":198,"_57":-7,"_9":199,"_23":196},{"_25":192,"_21":60,"_26":193,"_28":194,"_57":-7,"_9":195,"_23":192},{"_25":188,"_21":60,"_26":189,"_28":190,"_57":-7,"_9":191,"_23":188},{"_25":8,"_21":60,"_26":7,"_28":187,"_57":-7,"_9":10,"_23":8},{"_25":183,"_21":60,"_26":184,"_28":185,"_57":-7,"_9":186,"_23":183},{"_25":179,"_21":60,"_26":180,"_28":181,"_57":-7,"_9":182,"_23":179},"commands/version.mdx","version","Prints the version the installed script carries.","/docs/commands/version","commands/adopt.mdx","adopt","Points a clone at a canonical that moved. A clone records where it came from, so moving or renaming the canonical leaves every clone naming a directory that is gone. `adopt` writes the new location.","/docs/commands/adopt","Prints where a clone lives, for scripts and for `cd`.","commands/shell-init.mdx","shell-init","Emits a shell function and completions for bash and zsh. The function moves you into a clone as it is made and adds `gitto cd`:","/docs/commands/shell-init","commands/remove.mdx","remove","Removes a clone once it holds nothing you would miss.","/docs/commands/remove","commands/doctor.mdx","doctor","Reports what still points outside a clone after the copy: symbolic links into the canonical, virtual environments holding the old path, submodule history that did not come along, and worktrees the clone hosts for someone else.","/docs/commands/doctor","commands/prune.mdx","prune","Lists the clones whose branch is already merged into the canonical's upstream and which hold nothing uncommitted or unpushed. With `--remove`, it removes them.","/docs/commands/prune","commands/sync.mdx","sync","Fetches, moves the canonical forward when it can do so without a merge, and then runs whatever the project says brings it up to date.","/docs/commands/sync","commands/list.mdx","list","One line per clone: its name, its branch, how much is uncommitted, how much is unpushed, and what it costs on disk. The first line is the canonical and says how far behind its upstream it is.","/docs/commands/list","commands/new.mdx","new","Copies the canonical into `-` beside it, puts the copy on a new branch, and prints where it landed. The copy carries everything: history, submodules at every depth, dependencies, build output, and the files git was told to ignore.","/docs/commands/new","Concepts",[226,227,228,229],"concepts",{"_37":218,"_39":225},{"_25":222,"_21":60,"_26":216,"_28":223,"_57":221,"_9":224,"_23":222},"","concepts/index.mdx","The four words the commands and their refusals are written in.","/docs/concepts","concepts/meta.json",{"_25":242,"_21":60,"_26":243,"_28":244,"_57":-7,"_9":245,"_23":242},{"_25":238,"_21":60,"_26":239,"_28":240,"_57":-7,"_9":241,"_23":238},{"_25":234,"_21":60,"_26":235,"_28":236,"_57":-7,"_9":237,"_23":234},{"_25":230,"_21":60,"_26":231,"_28":232,"_57":-7,"_9":233,"_23":230},"concepts/shared-blocks.mdx","Shared blocks","Two files on the same filesystem holding the same storage until one of them is written to.","/docs/concepts/shared-blocks","concepts/address.mdx","Address","Everything inside a checkout that records where the checkout lives.","/docs/concepts/address","concepts/clone.mdx","Clone","A copy of the canonical, on its own branch, in its own directory beside it.","/docs/concepts/clone","concepts/canonical.mdx","Canonical","The checkout that clones are made from. It is an ordinary git checkout that nobody works in: it sits on the line you branch from, its dependencies are installed, its submodules are initialised, and its working tree is clean.","/docs/concepts/canonical","from-source.mdx","From source","Building it from a checkout of the repository.","","/docs/from-source","plugin.mdx","Plugin","What an agent is told, and how each client installs it.","","/docs/plugin","install.mdx","Install","One shell script, and the plugin that carries the skill.","","/docs/install","index.mdx","git worktree copies tracked files. gitto copies the whole checkout, dependencies and build output included, in seconds and for no disk.","","/docs","meta.json"]