# GitOne

> GitOne keeps public code and private files in one working directory and maps every file to exactly one Git repository. When it cannot tell where a file belongs, it stops.

GitOne is an open source command line tool (MIT, Linux and macOS) that wraps
native Git. One working directory holds several Git repositories:
`.gitone.yml` is committed and carries the public ownership map,
`.gitone.local.yml` is never committed and carries private repository names,
paths and remotes. Every relevant file must match the `paths` of exactly one
repository - a file that matches none stops the command with `PATH001`, a file
that matches two with `PATH002`. Nothing is guessed.

Underneath are ordinary Git repositories, so contributors who do not use GitOne
need nothing. Unknown commands and flags are rejected with `CLI001` rather than
forwarded to Git. There is no telemetry, no account and no server.

## Documentation
- [Usage guide](https://gitone.io/docs/usage): every command, what it refuses and why - configuration, the normal workflow, migration, branches, fetch, pull, push safety, recovery, the security boundary and the instruction block for AI agents.
- [Tutorial](https://gitone.io/docs/tutorial): every supported command, run start to finish against disposable projects.
- [Error codes](https://gitone.io/errors): all 22 codes, each with what it means, what causes it and what to do next.
- [Configuration examples](https://gitone.io/examples): worked `.gitone.yml` and `.gitone.local.yml` configurations, one per situation, each checked with the binary.
- [Full documentation, one file](https://gitone.io/llms-full.txt): the agent instruction block, both guides and the error reference, concatenated.

## Project
- [Home](https://gitone.io): what the tool does, what it deliberately does not do, and the VS Code extension.
- [Sponsors](https://gitone.io/sponsors): who funds the work.
- [Privacy](https://gitone.io/privacy): what this site does and does not collect.

## Source
- [Repository](https://github.com/devidevio/gitone): the code, the issues and the guides above at their source.
- [Releases](https://github.com/devidevio/gitone/releases/latest): binaries for Linux and macOS, and the VS Code extension.
- [Install script](https://gitone.io/install.sh): verifies the SHA-256 checksum before it installs anything.
- [Security policy](https://github.com/devidevio/gitone/blob/main/SECURITY.md): how to report a vulnerability.
- [License](https://github.com/devidevio/gitone/blob/main/LICENSE): MIT.