# Changelog: Respira CLI for WordPress

> Release notes for Respira CLI.

Source: https://www.respira.press/cli/docs/changelog

---

## 0.1.6 · The whole fleet · 2026-08-14

- `respira sites fleet` lists every site on your account, including team sites, with the plugin version and token status each one reports. Site keys stay out of the table unless you pass `--with-keys`.
- `respira sites list` prints the store file it actually read. It reads `~/.respira/sites.json`, the WordPress plugin keeps its own separate key store, and an empty list used to look the same as reading the wrong file. The path goes to stderr, so `--output json` stays parseable.
- The tool count in the welcome screen and `respira tools list` is now checked against the canonical catalog by the release surface check, instead of being a number nobody remembered to update.
- Version 0.1.5 was cut in the repository but never published to npm. Everything in it ships here.

## 0.1.4 · Voice and first run · 2026-04-21

- Branded first-run welcome on `respira auth login`: wordmark, a greeting, and the next commands worth running. Degrades below 40 columns and respects `NO_COLOR`.
- Two-line welcome on `respira auth whoami`. JSON output stays raw and machine-parseable.
- A formatter module in `@respira/cli-core` so success, error, warning and progress read the same everywhere.
- Empty states that say what to run next, instead of a bare `(no results)`, on `sites list`, `tools search` and `snapshots list`.

## 0.1.3 · Login that finishes · 2026-04-20

- The terminal no longer hangs after `respira auth login`. The local callback server held the connection open after sending its success page.
- `auth login` shows your email rather than a generic acknowledgement.
- Dropped the `keytar` dependency, which was printing a deprecation warning on every install.

## 0.1.2 · Reach the right host · 2026-04-20

- `respira auth login` failed with `request failed: fetch failed`. The default API base pointed at the apex, which redirects, and the redirect dropped the request.

## 0.1.1 · Readable on npm · 2026-04-20

- Per-package READMEs for `@respira/cli`, `@respira/sdk` and `@respira/cli-core`.

## 0.1.0 · Foundation release · 2026-04-19

First public release. The CLI ships alongside the Respira plugin and MCP server.

### Architecture

- Explicit six-phase execution cycle (load context, pre-hooks, resolve, execute, post-hooks, return).
- Framework-level hook contracts in place: `before_resolve`, `filter_plan`, `before_execute`, `filter_result`, `after_execute`. Callback registration and extension manifests arrive in v0.2\. The contracts are frozen and v0.1 to v0.2 is additive.
- Every command runs through the cycle. Structured JSON trace emission available with `--verbose`, written to `~/.respira/traces/`.
- Tool Chain Function abstraction for all 34 commands, each with capability class, domain tags, and prerequisite declarations. One command per file; the `ToolChainFunction` lives in the same file as the `BaseCommand` subclass, exported as `<camelCasePath>Function`.

### Commands

- 34 commands across 9 topics (auth 4, sites 5, read 8, write 7, snapshots 3, tools 3, find-element 1, exec 1, docs 1, init-claude-code 1).
- 45-tool catalog accessible via `respira tools list/describe/search`.
- `respira init-claude-code` generates a Claude Code skill that teaches the agent when and how to call the CLI.

### Free on any public WordPress URL

- `respira read structure <url>` detects 11 page builders and fetches the sitemap.
- `respira read design-system <url>` extracts colors and fonts.

### Packages

- `@respira/cli` 0.1.0
- `@respira/sdk` 0.1.0: typed TypeScript client with zod validation.
- `@respira/cli-core` 0.1.0: execution cycle, hook contracts, tool chain function interface, trace emitter, error taxonomy, auth/sites/output utilities.

### Install

```
npm install -g @respira/cli
```

MIT licensed. Node.js 18 or later. Works on macOS, Linux, and Windows.

For commit-level history, see the [CHANGELOG.md](https://github.com/respira-press/respira-wordpress-cli/blob/main/CHANGELOG.md) in the repository.