[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6},"actionData","errors","routes/docs",{"_7":8,"_9":10,"_11":12,"_13":14,"_15":16},"path","from-source.mdx","url","/docs/from-source","markdownUrl","/llms.mdx/docs/from-source/content.md","sourceFile","README.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":231},"$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":227,"_21":60,"_26":27,"_28":228,"_57":229,"_9":230,"_23":227},{"_25":222,"_21":60,"_26":223,"_28":224,"_57":225,"_9":226,"_23":222},{"_25":217,"_21":60,"_26":218,"_28":219,"_57":220,"_9":221,"_23":217},{"_25":8,"_21":60,"_26":214,"_28":215,"_57":216,"_9":10,"_23":8},{"_21":37,"_26":184,"_22":-7,"_50":-7,"_28":-7,"_51":-7,"_29":185,"_25":186,"_23":187,"_55":188,"_57":189},{"_21":37,"_26":154,"_22":-7,"_50":-7,"_28":-7,"_51":-7,"_29":155,"_25":156,"_23":157,"_55":158,"_57":159},{"_21":37,"_26":129,"_22":-7,"_50":-7,"_28":-7,"_51":-7,"_29":130,"_25":131,"_23":132,"_55":133,"_57":134},{"_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],"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":125,"_21":60,"_26":126,"_28":127,"_57":-7,"_9":128,"_23":125},{"_25":121,"_21":60,"_26":122,"_28":123,"_57":-7,"_9":124,"_23":121},{"_25":117,"_21":60,"_26":118,"_28":119,"_57":-7,"_9":120,"_23":117},{"_25":113,"_21":60,"_26":114,"_28":115,"_57":-7,"_9":116,"_23":113},{"_25":109,"_21":60,"_26":110,"_28":111,"_57":-7,"_9":112,"_23":109},{"_25":105,"_21":60,"_26":106,"_28":107,"_57":-7,"_9":108,"_23":105},{"_25":101,"_21":60,"_26":102,"_28":103,"_57":-7,"_9":104,"_23":101},{"_25":97,"_21":60,"_26":98,"_28":99,"_57":-7,"_9":100,"_23":97},"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/can-i-run-it-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/can-i-run-it-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",[139,140,141],"how-it-works",{"_37":131,"_39":138},{"_25":135,"_21":60,"_26":129,"_28":136,"_57":134,"_9":137,"_23":135},"","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":150,"_21":60,"_26":151,"_28":152,"_57":-7,"_9":153,"_23":150},{"_25":146,"_21":60,"_26":147,"_28":148,"_57":-7,"_9":149,"_23":146},{"_25":142,"_21":60,"_26":143,"_28":144,"_57":-7,"_9":145,"_23":142},"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",[164,165,166,167],"commands",{"_37":156,"_39":163},{"_25":160,"_21":60,"_26":154,"_28":161,"_57":159,"_9":162,"_23":160},"","commands/index.mdx","Four commands, what each one takes, and what each one refuses.","/docs/commands","commands/meta.json",{"_25":180,"_21":60,"_26":181,"_28":182,"_57":-7,"_9":183,"_23":180},{"_25":176,"_21":60,"_26":177,"_28":178,"_57":-7,"_9":179,"_23":176},{"_25":172,"_21":60,"_26":173,"_28":174,"_57":-7,"_9":175,"_23":172},{"_25":168,"_21":60,"_26":169,"_28":170,"_57":-7,"_9":171,"_23":168},"commands/remove.mdx","remove","Deletes a clone, once it has established that nothing would be lost.","/docs/commands/remove","commands/doctor.mdx","doctor","Reports what still points outside a clone: symlinks into the canonical, absolute hook paths, submodule git directories that escaped, and worktrees the clone hosts for someone else.","/docs/commands/doctor","commands/list.mdx","list","Prints the canonical and every clone beside it, with each one's branch, how many uncommitted changes it holds and how many commits it has that its upstream does not.","/docs/commands/list","commands/new.mdx","new","Copies the canonical into `-` beside it, puts the copy on a branch called ``, and prints the path.","/docs/commands/new","Concepts",[194,195,196,197],"concepts",{"_37":186,"_39":193},{"_25":190,"_21":60,"_26":184,"_28":191,"_57":189,"_9":192,"_23":190},"","concepts/index.mdx","The four words the commands and their refusals are written in.","/docs/concepts","concepts/meta.json",{"_25":210,"_21":60,"_26":211,"_28":212,"_57":-7,"_9":213,"_23":210},{"_25":206,"_21":60,"_26":207,"_28":208,"_57":-7,"_9":209,"_23":206},{"_25":202,"_21":60,"_26":203,"_28":204,"_57":-7,"_9":205,"_23":202},{"_25":198,"_21":60,"_26":199,"_28":200,"_57":-7,"_9":201,"_23":198},"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","Building it from a checkout of the repository.","","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"]