Référence : commandes

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# Référence : commandes

## `sidekicks`

```text
sidekicks [--config <fichier>]
```

| Option / variable | Effet |
| --- | --- |
| `--config <fichier>` | Fichier de configuration à utiliser. Prioritaire sur tout le reste. |
| `SIDEKICKS_CONFIG` | Fichier de configuration quand `--config` n'est pas donné. |
| (aucune) | `<dossier de config utilisateur>/sidekicks/config.yaml`, créé avec des commentaires s'il manque. |

L'ordre est détaillé dans la [référence de la configuration](configuration.md#emplacement).

## Cibles `make`

| Cible | Effet |
| --- | --- |
| `help` | Liste les cibles. |
| `install` | `pnpm install` dans `frontend/` (binaires natifs macOS et Linux). |
| `bindings` | Régénère `frontend/bindings` à partir des services et événements Go (`wails3 generate bindings -clean=true -ts -i`). |
| `frontend` | `install`, puis construit `frontend/dist`. |
| `dev` | `wails3 dev` : l'application avec rechargement à chaud. |
| `build` | `wails3 build` : `bin/sidekicks`. |
| `package` | `wails3 package` : sous macOS `bin/sidekicks.app`. |
| `install-test-config` | `scripts/install-test-config.sh` : écrit `examples/test-agents.yaml` à l'emplacement par défaut de la configuration, avec des chemins absolus vers le dépôt : chaque agent est `mm -acp -config agent.yaml` lancé dans son dossier, avec `afterStop: [<dépôt>/scripts/agents.sh, unload, <agent>]` pour décharger son modèle à l'arrêt, `mm` écrit avec son chemin absolu (`MM_BIN`, ou celui du `PATH`), et le `PATH` courant dans l'`env` de chaque agent ; un fichier existant est gardé sous `config.yaml.<date>.bak`. |
| `check` | `lint` puis `test`. |
| `test` | `test-go`, `test-frontend`, `test-scripts`. |
| `test-go` | `go test ./...` (construit `frontend/dist` d'abord s'il manque). |
| `test-frontend` | `vitest run` dans `frontend/`. |
| `test-scripts` | `scripts/agents_test.sh` et `scripts/check-license-headers_test.sh`. |
| `test-real` | `go test -tags realagents -count=1 ./...` — nécessite `mm` et llmman. |
| `lint` | `lint-go`, `lint-frontend`, `lint-headers`. |
| `lint-go` | golangci-lint v2.14.0 (`tools/go.mod`), configuration `.golangci.yml`. |
| `lint-frontend` | `svelte-check`. |
| `lint-headers` | `scripts/check-license-headers.sh`. |
| `bindings-check` | `bindings`, puis échoue si `frontend/bindings` diffère de la version commitée. |

## `scripts/check-license-headers.sh`

```text
scripts/check-license-headers.sh [racine du dépôt]
```

Liste les fichiers sources (`.go .ts .js .svelte .css .html .sh .py .yml .yaml`, `Makefile`) connus de git dont les trois premières lignes ne contiennent pas `Sidekicks Source-Available License`, et se termine avec le code 1 s'il y en a. Non vérifiés : `frontend/bindings`, `build/` et `Taskfile.yml` de Wails, `*.d.ts`, `pnpm-lock.yaml`, `vite.config.ts`, `svelte.config.js`, `agents/`, `*/testdata/*`, `git.sh`, `new.*.sh`, `tag-step.sh`, `.claude/`, `.tickets/`.

## CI

`.github/workflows/ci.yml`, à chaque push et merge request : installe Go (version de `go.mod`), Node 22, pnpm (version de `frontend/package.json`), les paquets de build GTK 4 / WebKitGTK 6 et la CLI Wails, puis lance `make bindings-check` et `make check`.