SDK & CLI
@azothos/cli
The azoth command: relay an AI coding tool’s calls through the gateway, name those calls in your commits, report usage, ask the router for a model and run regression suites in CI.
npm install -g @azothos/cli
azoth --help
# or without installing
npx @azothos/cli --helpThe package is @azothos/cli, for Node.js 18 or later. There is no @azoth/cli, and npx azoth is not Azoth: that npm name belongs to someone else.
Configuration
Set AZOTH_API_KEY — and AZOTH_BASE_URL for a self-hosted deployment — or write them as apiKey and baseUrl in ~/.azoth/config.json. The environment wins.
azoth proxy
- A relay on your machine for any tool that takes an OpenAI base URL: point it at
http://127.0.0.1:8787/v1, with any API key. - Each call goes to your workspace’s gateway with your workspace key, governed and sealed there; the tool’s own key is never forwarded.
- The relay keeps only the reference each answer carries — its signed receipt, or the trace of a streamed answer — in
~/.azoth/receipts.jsonl, for 7 days. It answers this machine only.
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
- Adds a git
commit-msghook to the current repository: each commit gets oneAzoth-Receipt:trailer per call the relay saw since the last commit, the latest 5. - When Azoth reads the repository, such a commit is shown as attached to the sealed call: it names a call the gateway sealed, never a proof that the code came from it.
- The hook never blocks a commit, adds nothing to an empty message or a merge, and never overwrites a hook it did not write — with husky or commitlint, add
azoth hook run "$1" || trueto yours.azoth hook uninstallremoves it.
azoth hook install
git commit -m "Fix the retry on 429"
# → Azoth-Receipt: eyJhbGciOiJFZERTQSIs… (one trailer per relayed call, the latest 5)Other commands
azoth ingest [file]Report usage events from a file, stdin or flags
azoth routeAsk the router for a model (
--mode cost|quality|balanced)azoth budgetPrint each budget and its use;
--exit-on-exceeded makes a CI gateazoth test run <suite.json>Run a regression suite through the gateway; exits 1 when a case fails
In CI
# .github/workflows/ai-regression.yml
- run: npx --yes @azothos/cli test run suite.json
env:
AZOTH_API_KEY: ${{ secrets.AZOTH_API_KEY }}