# gitrdone

> gitrdone is an authenticated Git smart HTTP service with a small control API for creating backing Git repos and repo-scoped access tokens.

gitrdone is intended to be used by Differ services and trusted agents as a Git backend. Use canonical repo IDs, not namespace/name, as the Git identity. Public discovery files are safe to scrape. Control and Git operations require the appropriate tokens.

For retriable automation, include Idempotency-Key on token creation and derive it from the stable logical operation.

List and revoke repo tokens with the control bearer token; token values are returned only at creation.

## Agent Docs

- [Agent guide](https://grd-local.differ.ac/AGENTS.md): Full machine-readable guide for agents using this service.
- [Lowercase agent guide alias](https://grd-local.differ.ac/agents.md): Same guide at a lowercase path.
- [Well-known agent guide alias](https://grd-local.differ.ac/.well-known/agents.md): Same guide under .well-known.
- [Full LLM context](https://grd-local.differ.ac/llms-full.txt): Same full guide for tools that look for llms-full.txt.
- [Markdown sitemap](https://grd-local.differ.ac/sitemap.md): Agent-readable list of guide and service surfaces.

## API Surface

- [Health](https://grd-local.differ.ac/healthz): Minimal service health check.
- [Create repo](https://grd-local.differ.ac/v1/repos): POST with control bearer token.
- [Repo tokens](https://grd-local.differ.ac/v1/repos/{repoID}/tokens): POST to create; GET to list metadata with control bearer token.
- [Revoke repo token](https://grd-local.differ.ac/v1/repos/{repoID}/tokens/{tokenID}/revoke): POST with control bearer token.
- [Git smart HTTP](https://grd-local.differ.ac/git/repos/{repoID}.git): Use normal Git commands with repo-scoped tokens.

## Optional

- [robots.txt](https://grd-local.differ.ac/robots.txt)
- [XML sitemap](https://grd-local.differ.ac/sitemap.xml)