[{"_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":276},"$id","name","gitto","description","children",[40,41,42,43,44,45,46,47,48,49],"fallback",{"_21":22,"_23":33,"_25":34,"_26":35,"_28":-7,"_29":36},{"_37":38,"_39":-7},"fallback:root","Docs",[],"folder","","meta",{"_25":272,"_21":61,"_26":27,"_28":273,"_58":274,"_9":275,"_23":272},{"_25":267,"_21":61,"_26":268,"_28":269,"_58":270,"_9":271,"_23":267},{"_25":262,"_21":61,"_26":263,"_28":264,"_58":265,"_9":266,"_23":262},{"_25":257,"_21":61,"_26":258,"_28":259,"_58":260,"_9":261,"_23":257},{"_21":37,"_26":227,"_22":-7,"_51":-7,"_28":-7,"_52":-7,"_29":228,"_25":229,"_23":230,"_56":231,"_58":232},{"_21":37,"_26":165,"_22":-7,"_51":-7,"_28":-7,"_52":-7,"_29":166,"_25":167,"_23":168,"_56":169,"_58":170},{"_21":37,"_26":140,"_22":-7,"_51":-7,"_28":-7,"_52":-7,"_29":141,"_25":142,"_23":143,"_56":144,"_58":145},{"_25":135,"_21":61,"_26":136,"_28":137,"_58":138,"_9":139,"_23":135},{"_21":37,"_26":80,"_22":-7,"_51":-7,"_28":-7,"_52":-7,"_29":81,"_25":82,"_23":83,"_56":84,"_58":85},{"_21":37,"_26":50,"_22":-7,"_51":-7,"_28":-7,"_52":-7,"_29":53,"_25":54,"_23":55,"_56":57,"_58":59},"Caveats","defaultOpen","collapsible",[65,66,67],"caveats",{"_37":54,"_39":64},"index",{"_25":60,"_21":61,"_26":50,"_28":62,"_58":59,"_9":63,"_23":60},"icon","","caveats/index.mdx","page","What it cannot see, and what a copy cannot carry.","/docs/caveats","caveats/meta.json",{"_25":76,"_21":61,"_26":77,"_28":78,"_58":-7,"_9":79,"_23":76},{"_25":72,"_21":61,"_26":73,"_28":74,"_58":-7,"_9":75,"_23":72},{"_25":68,"_21":61,"_26":69,"_28":70,"_58":-7,"_9":71,"_23":68},"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",[90,91,92,93,94,95,96,97,98],"questions",{"_37":82,"_39":89},{"_25":86,"_21":61,"_26":80,"_28":87,"_58":85,"_9":88,"_23":86},"","questions/index.mdx","Short answers to what people ask before they install it.","/docs/questions","questions/meta.json",{"_25":131,"_21":61,"_26":132,"_28":133,"_58":-7,"_9":134,"_23":131},{"_25":127,"_21":61,"_26":128,"_28":129,"_58":-7,"_9":130,"_23":127},{"_25":123,"_21":61,"_26":124,"_28":125,"_58":-7,"_9":126,"_23":123},{"_25":119,"_21":61,"_26":120,"_28":121,"_58":-7,"_9":122,"_23":119},{"_25":115,"_21":61,"_26":116,"_28":117,"_58":-7,"_9":118,"_23":115},{"_25":111,"_21":61,"_26":112,"_28":113,"_58":-7,"_9":114,"_23":111},{"_25":107,"_21":61,"_26":108,"_28":109,"_58":-7,"_9":110,"_23":107},{"_25":103,"_21":61,"_26":104,"_28":105,"_58":-7,"_9":106,"_23":103},{"_25":99,"_21":61,"_26":100,"_28":101,"_58":-7,"_9":102,"_23":99},"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","comparison.mdx","Comparison","Worktree managers, whole-tree CoW clones, and what each one leaves you holding.","","/docs/comparison","How it works",[150,151,152],"how-it-works",{"_37":142,"_39":149},{"_25":146,"_21":61,"_26":140,"_28":147,"_58":145,"_9":148,"_23":146},"","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":161,"_21":61,"_26":162,"_28":163,"_58":-7,"_9":164,"_23":161},{"_25":157,"_21":61,"_26":158,"_28":159,"_58":-7,"_9":160,"_23":157},{"_25":153,"_21":61,"_26":154,"_28":155,"_58":-7,"_9":156,"_23":153},"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",[175,176,177,178,179,180,181,182,183,184,185],"commands",{"_37":167,"_39":174},{"_25":171,"_21":61,"_26":165,"_28":172,"_58":170,"_9":173,"_23":171},"","commands/index.mdx","Four commands, what each one takes, and what each one refuses.","/docs/commands","commands/meta.json",{"_25":223,"_21":61,"_26":224,"_28":225,"_58":-7,"_9":226,"_23":223},{"_25":219,"_21":61,"_26":220,"_28":221,"_58":-7,"_9":222,"_23":219},{"_25":215,"_21":61,"_26":216,"_28":217,"_58":-7,"_9":218,"_23":215},{"_25":211,"_21":61,"_26":212,"_28":213,"_58":-7,"_9":214,"_23":211},{"_25":207,"_21":61,"_26":208,"_28":209,"_58":-7,"_9":210,"_23":207},{"_25":203,"_21":61,"_26":204,"_28":205,"_58":-7,"_9":206,"_23":203},{"_25":199,"_21":61,"_26":200,"_28":201,"_58":-7,"_9":202,"_23":199},{"_25":8,"_21":61,"_26":7,"_28":198,"_58":-7,"_9":10,"_23":8},{"_25":194,"_21":61,"_26":195,"_28":196,"_58":-7,"_9":197,"_23":194},{"_25":190,"_21":61,"_26":191,"_28":192,"_58":-7,"_9":193,"_23":190},{"_25":186,"_21":61,"_26":187,"_28":188,"_58":-7,"_9":189,"_23":186},"commands/version.mdx","version","Prints the version the installed script carries.","/docs/commands/version","commands/update.mdx","update","Replaces the running script with what `https://gitto.13e7.co/gitto` serves, after checking that what arrived parses. `GITTO_SOURCE_URL` points it somewhere else.","/docs/commands/update","commands/adopt.mdx","adopt","Points the current directory at that canonical. It does one of two things, depending on what the directory already is.","/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, worktrees the clone hosts for someone else, and settings files in fixed places that name the clone by path.","/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. It holds the canonical alone while it runs, so no clone is copied out of a tree that is moving.","/docs/commands/sync","commands/list.mdx","list","One line per clone: its name, its branch, how much is uncommitted, how much is unpushed, how long since anything happened in it, and what the copy cost when it was made. 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",[237,238,239,240],"concepts",{"_37":229,"_39":236},{"_25":233,"_21":61,"_26":227,"_28":234,"_58":232,"_9":235,"_23":233},"","concepts/index.mdx","The four words the commands and their refusals are written in.","/docs/concepts","concepts/meta.json",{"_25":253,"_21":61,"_26":254,"_28":255,"_58":-7,"_9":256,"_23":253},{"_25":249,"_21":61,"_26":250,"_28":251,"_58":-7,"_9":252,"_23":249},{"_25":245,"_21":61,"_26":246,"_28":247,"_58":-7,"_9":248,"_23":245},{"_25":241,"_21":61,"_26":242,"_28":243,"_58":-7,"_9":244,"_23":241},"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","gitto copies a whole working directory with the filesystem's own clone call: history, submodules, dependencies and build output, then re-addresses what the copy would break. Nothing is duplicated until one side writes.","","/docs","meta.json"]