Getting started

Install gitevolved and make your first clone and push. Two minutes, no cloud account needed to start.

1. Install

Easiest: let your AI agent do it

Paste this to Claude Code, Codex, Gemini, or any coding agent:

Install gitevolved from github.com/do-awesome-ai/gitevolved,
then make sure `git clone dosource://cloud/<repo>` works.

It reads the repo's AGENTS.md and runs the steps. See AI-agent setup for per-agent prompts.

With Go (one command per tool)

go install github.com/do-awesome-ai/gitevolved/cmd/git-remote-dosource@latest
go install github.com/do-awesome-ai/gitevolved/cmd/gitevolved@latest
go install github.com/do-awesome-ai/gitevolved/cmd/dosourced@latest
export PATH="$(go env GOPATH)/bin:$PATH"   # if not already on PATH

No Go? Prebuilt binaries

Download the archive for your OS/arch from the latest release and put the three binaries on PATH. Or clone the repo and run ./install.sh.

Verify

git-remote-dosource --version

2. Clone a hosted repo

For cloud repos you need a doSource API key (set it once):

export DOSOURCE_API_KEY="<your key>"
git clone dosource://cloud/<repo> my-checkout

That's a normal git clone — you now have a real git working tree.

3. Edit and push

cd my-checkout
# ...edit files...
git add -A && git commit -m "my change"
git push dosource://cloud/<repo>        # lands on the shared codebase
git push origin main                     # your GitHub remote, untouched

If a teammate pushed a change to a different part of the same file meanwhile, both land — no conflict to resolve.

Fully local (no cloud)

You can use gitevolved entirely offline against a local operation log — see the CLI reference for gitevolved record, materialize, and export.