# @azothos/cli

La commande `azoth` : relayer par la passerelle les appels d’un outil de code par IA, nommer ces appels dans vos commits, déclarer l’usage, demander un modèle au routeur et lancer des suites de régression en CI.

```
npm install -g @azothos/cli
azoth --help

# or without installing
npx @azothos/cli --help
```

> Le paquet est `@azothos/cli`, pour Node.js 18 ou plus récent. Il n’existe pas de `@azoth/cli`, et `npx azoth` n’est pas Azoth : ce nom npm appartient à quelqu’un d’autre.

## Configuration

Définissez `AZOTH_API_KEY` — et `AZOTH_BASE_URL` pour un déploiement auto-hébergé — ou écrivez-les sous `apiKey` et `baseUrl` dans `~/.azoth/config.json`. L’environnement l’emporte.

## azoth proxy

- Un relais sur votre machine pour tout outil qui accepte une URL de base OpenAI : pointez-le vers `http://127.0.0.1:8787/v1`, avec n’importe quelle clé API.
- Chaque appel va à la passerelle de votre espace de travail avec la clé de votre espace, gouverné et scellé là-bas ; la clé propre à l’outil n’est jamais transmise.
- Le relais ne garde que la référence que porte chaque réponse — son reçu signé, ou la trace d’une réponse en streaming — dans `~/.azoth/receipts.jsonl`, pendant 7 jours. Il ne répond qu’à cette machine.

```
azoth proxy                                      # relay on http://127.0.0.1:8787/v1
export OPENAI_BASE_URL=http://127.0.0.1:8787/v1   # or the tool's own setting; any API key
```

## azoth hook install

- Ajoute un hook git `commit-msg` au dépôt courant : chaque commit reçoit une mention `Azoth-Receipt:` par appel que le relais a vu depuis le dernier commit, les 5 plus récents.
- Quand Azoth lit le dépôt, un tel commit est affiché comme rattaché à l’appel scellé : il nomme un appel que la passerelle a scellé, jamais la preuve que le code en vient.
- Le hook ne bloque jamais un commit, n’ajoute rien à un message vide ni à un merge, et n’écrase jamais un hook qu’il n’a pas écrit — avec husky ou commitlint, ajoutez `azoth hook run "$1" || true` au vôtre. `azoth hook uninstall` le retire.

```
azoth hook install

git commit -m "Fix the retry on 429"
# → Azoth-Receipt: eyJhbGciOiJFZERTQSIs…   (one trailer per relayed call, the latest 5)
```

## Autres commandes

- `azoth ingest [file]` — Déclarer des événements d’usage depuis un fichier, stdin ou des options
- `azoth route` — Demander un modèle au routeur (`--mode cost|quality|balanced`)
- `azoth budget` — Afficher chaque budget et son utilisation ; `--exit-on-exceeded` en fait un contrôle de CI
- `azoth test run <suite.json>` — Lancer une suite de régression par la passerelle ; sort avec le code 1 quand un cas échoue

## En CI

```
# .github/workflows/ai-regression.yml
- run: npx --yes @azothos/cli test run suite.json
  env:
    AZOTH_API_KEY: ${{ secrets.AZOTH_API_KEY }}
```
