Start free →

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 --help

The 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 key

azoth hook install

  • Adds a git commit-msg hook to the current repository: each commit gets one Azoth-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" || true to yours. azoth hook uninstall removes 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 route
Ask the router for a model (--mode cost|quality|balanced)
azoth budget
Print each budget and its use; --exit-on-exceeded makes a CI gate
azoth 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 }}