Démarrer gratuitement →

SDK et CLI

@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 }}