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 --helpLe 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 keyazoth hook install
- Ajoute un hook git
commit-msgau dépôt courant : chaque commit reçoit une mentionAzoth-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" || trueau vôtre.azoth hook uninstallle 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 routeDemander un modèle au routeur (
--mode cost|quality|balanced)azoth budgetAfficher chaque budget et son utilisation ;
--exit-on-exceeded en fait un contrôle de CIazoth 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 }}