# repos-devtools-server

Local HTTP API bound to **`127.0.0.1`** for git operations under **`REPOS_DEVTOOLS_ROOT`** (default `/home/ncantu/code`).

## Environment

| Variable | Required | Description |
|----------|----------|-------------|
| `REPOS_DEVTOOLS_TOKEN` | yes | Shared secret; clients send `Authorization: Bearer <token>`. |
| `REPOS_DEVTOOLS_ROOT` | no | Absolute root for clones (default `/home/ncantu/code`). |
| `REPOS_DEVTOOLS_HOST` | no | Bind address (default `127.0.0.1`). |
| `REPOS_DEVTOOLS_PORT` | no | Port (default `37140`). |

## Endpoints

- `POST /repos-clone` — JSON `{ "url": "<git url>", "branch": "test" }` (`branch` optional, default `test`).
- `GET /repos-list` — Lists immediate subdirectories of the root that contain `.git`.
- `POST /repos-load` — JSON `{ "name": "<folder name>" }` — Verifies the repo exists; returns absolute `path`.

All endpoints require `Authorization: Bearer <REPOS_DEVTOOLS_TOKEN>`.

## Run

```bash
cd services/repos-devtools-server
npm install
npm run build
export REPOS_DEVTOOLS_TOKEN='generate-a-long-random-secret'
npm start
```

Use the same token in the VS Code / Cursor setting **`anythingllm.reposApiToken`**.

## Integration

The **AnythingLLM Workspaces** extension command **AnythingLLM: Dev tools panel** calls this API and the AnythingLLM HTTP API for workspace create/list.