# Changelog

All notable changes to `aimlapi` (and its alias `aimlapi-cli`) are listed here. Versions follow
[Semantic Versioning](https://semver.org). The same notes are published with
each GitHub Release.

## 0.3.0 - 2026-09-24

- Install without Node.js: `curl -fsSL https://aimlapi.com/install.sh | sh`
  (macOS, Linux) and `irm https://aimlapi.com/install.ps1 | iex` (Windows).
  The scripts download the binary from the npm registry, verify its sha512
  and install it into `~/.local/bin` (Windows: `%LOCALAPPDATA%\aimlapi\bin`).
  They install 0.3.0 or newer (the first version that can update itself);
  pin an older one with `AIMLAPI_VERSION`.
- `aimlapi update` on a binary installed by the script downloads, verifies
  and replaces the binary itself instead of running `npm i -g`. It never
  downgrades (a newer build or a pinned rc stays) and leaves development
  builds alone; crossing a major version is allowed, as with npm.
- `aimlapi <agent>` offers to install a missing agent: in a terminal it
  prints the exact command and asks, e.g. `Claude Code is not installed.
  Install it now? npm install -g @anthropic-ai/claude-code [Y/n]`, then goes
  on with the model picker and the launch. `--yes` (`-y`) installs without
  asking; without a terminal, with `CI` set or with `--dry-run` nothing is
  installed and the command is only printed (exit code 4, as before). Only
  the official npm packages of Claude Code, Codex, OpenCode, Cline,
  OpenClaude, OpenClaw and zero; never with `sudo`. Hermes Agent and ZCode
  keep their manual install instructions.

## 0.2.0 - 2026-09-24

- First public version: `aimlapi claude|codex|opencode|cline|openclaude|openclaw|hermes|zero|zcode`
  connects the agent to AI/ML API; `login`, `logout`, `status`, `models`.
- `aimlapi openclaude` connects [OpenClaude](https://github.com/Gitlawb/openclaude)
  to AI/ML API over its Anthropic-compatible route.
- `aimlapi openclaw` connects [OpenClaw](https://github.com/openclaw/openclaw): it writes the AI/ML API provider and
  default model into `openclaw.json`, which reads the key from aimlapi's
  credentials file (no copy of the key); `--undo` restores the previous config.
- `aimlapi zero` connects [zero](https://github.com/Gitlawb/zero) (Gitlawb): it
  adds an AI/ML API provider profile to zero's `config.json` that reads the key
  from `$AIMLAPI_CLI_KEY` (`$AIMLAPI_CLI_DEV_KEY` for `--env dev`), which the
  launch sets for zero only; `--config` makes it zero's default provider and
  `--undo` restores the previous one.
- `aimlapi zcode` connects [ZCode](https://github.com/zai-org/ZCode), Z.ai's
  coding agent for GLM models, to AI/ML API as an OpenAI-compatible provider;
  `--config` also sets up the ZCode desktop app.
- `aimlapi hermes` connects [Hermes Agent](https://hermes-agent.nousresearch.com): it adds the
  AI/ML API provider to Hermes' `config.yaml`, which gets the key by running `aimlapi key print`
  (no copy of the key); a launch selects it for that run only, `--config` makes it the default;
  `--undo` restores the previous config.
- Platforms: macOS and Linux (x64, arm64); Windows (x64, arm64) is experimental.
- npm packages: `aimlapi` (`npx aimlapi claude`, `npm i -g aimlapi`) and the
  alias `aimlapi-cli`, with the same `aimlapi` command.