# Extension AnythingLLM (`extensions/anythingllm-workspaces/`)

**Surface préférée** : le service HTTP [`services/anythingllm-devtools/`](../../services/anythingllm-devtools/) — même orchestration (repos-devtools, workspaces AnythingLLM, upload RAG initial `.4nkaiignore`) ; l’orchestrateur, les agents et les scripts appellent ce service plutôt que l’IDE.

Extension **VS Code / Cursor** (héritée) : API développeur AnythingLLM, **repos-devtools-server** optionnel, panneau **Dev tools**, mêmes commandes que `POST /v1/devtools/run` côté service.

## Prérequis

- AnythingLLM avec **clé API développeur** (ne pas confondre avec le Bearer nginx pour `/ollama/`).
- **repos-devtools-server** sur l’hôte qui possède les clones (défaut `http://127.0.0.1:37140`) — [service-repos-devtools.md](./service-repos-devtools.md).
- Processeur de documents en ligne pour les uploads.

## Paramètres (settings)

| Clé | Rôle |
|-----|------|
| `anythingllm.baseUrl` | URL AnythingLLM sans `/` final |
| `anythingllm.apiKey` | Clé API (settings utilisateur) |
| `anythingllm.reposApiBaseUrl` | URL repos-devtools |
| `anythingllm.reposApiToken` | Identique à `REPOS_DEVTOOLS_TOKEN` |
| `anythingllm.initialSyncAfterClone` | Défaut activé : upload après clone/load/workspace-sync |
| `anythingllm.initialSyncMaxFiles` | Défaut `400` |
| `anythingllm.initialSyncMaxFileBytes` | Défaut `5242880` |

## Commandes (palette)

List workspaces, ouvrir UI web, panneau Dev tools, lignes de commande scriptées (`/repos-clone-sync`, `/repos-load-sync`, `/workspace-sync`, …).

## `.4nkaiignore`

- Modèle canonique : `services/anythingllm-devtools/templates/4nkaiignore.default` (aligné avec repos-devtools-server) ; copie sous l’extension conservée pour compatibilité.
- À la racine du dépôt cible : fichier **`.4nkaiignore`**.
- Filtrage : paquet **`ignore`** (sémantique gitignore) + règles de base (`.git/`, `node_modules/`, …).

## Build

```bash
cd extensions/anythingllm-workspaces
npm install
npm run compile
```

## Références

API documents AnythingLLM amont ; [anythingllm-workspaces.md](../anythingllm-workspaces.md).