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 in the repository.