# repos-devtools-server (`services/repos-devtools-server/`)

API HTTP locale sur **`127.0.0.1`** pour des opérations Git sous **`REPOS_DEVTOOLS_ROOT`** (défaut souvent `/home/ncantu/code` — à adapter sur chaque poste).

Après un **`POST /repos-clone`** réussi, si le dépôt n’a pas **`.4nkaiignore`**, le serveur copie **`templates/4nkaiignore.default`** à la racine du clone. La réponse inclut **`fourNkAiIgnoreTemplateWrote`**.

## Variables d’environnement

| Variable | Obligatoire | Description |
|----------|-------------|-------------|
| `REPOS_DEVTOOLS_TOKEN` | oui | `Authorization: Bearer <token>` sur chaque requête. |
| `REPOS_DEVTOOLS_ROOT` | non | Racine des clones. |
| `REPOS_DEVTOOLS_HOST` | non | Adresse d’écoute (défaut `127.0.0.1`). |
| `REPOS_DEVTOOLS_PORT` | non | Port (défaut `37140`). |

## Endpoints

- `POST /repos-clone` — JSON `{ "url": "<git>", "branch": "test" }` (`branch` optionnel).
- `GET /repos-list`
- `POST /repos-load` — JSON `{ "name": "<folder>" }`

## Exécution

```bash
cd services/repos-devtools-server
npm install
npm run build
export REPOS_DEVTOOLS_TOKEN='…'
npm start
```

Unité systemd utilisateur possible : `systemctl --user daemon-reload && systemctl --user restart repos-devtools-server.service` après installation d’une unité locale.

## Templates

Maintenir **`templates/4nkaiignore.default`** aligné avec `services/anythingllm-devtools/templates/4nkaiignore.default` (et, pour compatibilité, `extensions/anythingllm-workspaces/templates/4nkaiignore.default`).

## Spécification HTTP

[API/repos-devtools-server.md](../API/repos-devtools-server.md)