@jacobbd/relay-ai 0.2.5 → 0.2.7

package/.markdown-link-check.json

@@ -0,0 +1,7 @@
+{
+  "ignorePatterns": [
+    {
+      "pattern": "^https://www\\.npmjs\\.com/package/"
+    }
+  ]
+}

package/AGENTS.md

@@ -150,9 +150,9 @@ In all cases `process.env['OPENCODE_API_KEY']` is set immediately so the key is
 - `--restore` globs `models-*.json` (CLI) and `app-models-*.json` (App); the new files are `models-favorites.json` and `app-models-favorites.json`.
 - Zen/Go favorites are skipped in Codex (use Claude or Desktop gateway).
 
-## Release status (v0.2.5)
+## Release status (v0.2.6)
 
-Current version is **v0.2.5** — native provider registry, agent boot flags (`--provider` / `--model`), `relay-ai --ai`, Codex favorites catalog, Codex App restore handling, reasoning capability metadata, and OpenCode cloud provider setup in `relay-ai providers add`.
+Current version is **v0.2.6** — official launch release with the native provider registry, complete Claude/Codex app help, unified OpenCode Zen / Go setup, duplicate-provider migration, stable post-import refreshes, agent boot flags (`--provider` / `--model`), `relay-ai --ai`, favorites catalogs, and reasoning capability metadata.
 
 **Known limitations (by design):**
 - Cost display in Codex is always inaccurate for non-Anthropic models.

package/CHANGELOG.md

@@ -1,13 +1,17 @@
 # Changelog
 
-## [0.2.5] - 2026-06-18 (Official Launch Release)
+## [0.2.7] - 2026-06-19 (Official Launch Release)
 
 ### Added
 - **Native provider registry** — Add, list, remove, refresh, and import providers with secure OS credential storage and templates for OpenRouter, Groq, Mistral, Together AI, Zen/Go, and SDK-backed custom endpoints.
-- **Claude Code and Codex launchers** — Launch registry models through `relay-ai`, including provider/model boot flags, local OpenCode provider discovery, recent models, search, pagination, and favorites catalogs for mid-session switching.
+- **Claude Code launcher** — Launch registry models through `relay-ai claude`, including provider/model boot flags, local OpenCode provider discovery, recent models, search, pagination, and favorites catalogs for mid-session switching.
+- **Codex CLI launcher** — Launch the Codex terminal with registry providers via `relay-ai codex`.
+- **Codex App launcher** — Launch the Codex desktop app with registry providers via `relay-ai codex-app`. Preserves existing conversation history by keeping Codex's built-in OpenAI provider identity; routes the selected model through a foreground local Responses proxy. Supports `--trace` for proxy debug logging.
 - **Unified SDK gateway** — Route non-Anthropic providers through the Vercel AI SDK adapter while preserving Anthropic-compatible tool use, streaming, context windows, and model catalogs.
-- **Codex App integration** — Launch the desktop app with registry providers and restore Codex App model settings after interrupted sessions.
-- **Reasoning capability metadata** — Resolve reasoning controls from provider metadata, including OpenRouter `supported_parameters`, so models such as GLM 5.2 receive compatible reasoning options instead of stale defaults.
+- **Claude Desktop integration** — Launch Claude Desktop in third-party provider mode with automatic configuration backup and restore.
 - **Foreground server gateway** — Run `relay-ai server` for Claude Desktop or LAN usage, with registry-backed routing, password protection, and optional Vertex AI support.
+- **Reasoning capability metadata** — Resolve reasoning controls from provider metadata, including OpenRouter `supported_parameters`, so models receive compatible reasoning options.
+- **Favorites catalogs** — Save up to 20 models and switch mid-session in Claude Code (`/model`) and Codex.
 - **First-run setup** — Configure providers from an inline wizard or import existing OpenCode provider settings.
-
+- **Complete command help** — Every top-level command fully documented, including `codex-app`, `claude-app`, Vertex, restore, config, trace, and agent-reference flags.
+- **Agent / headless launch** — Boot flags (`--provider`, `--model`), clean NDJSON/JSONL stdout, and `relay-ai --ai` reference for scripts and alef-agent.

package/README.md

@@ -8,7 +8,7 @@
 > Relay any model into any coding agent — launch tools, switch providers, and run local API gateways.
 
 [![npm version](https://img.shields.io/npm/v/@jacobbd/relay-ai)](https://www.npmjs.com/package/@jacobbd/relay-ai)
-[![License](https://img.shields.io/npm/l/@jacobbd/relay-ai)](https://github.com/jacob-bd/relay-ai/blob/main/LICENSE)
+[![License](https://img.shields.io/npm/l/@jacobbd/relay-ai)](LICENSE)
 [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-FFDD00?style=flat-square&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/jacobbd)
 
 **relay-ai** is an interactive CLI that launches AI coding tools and runs local API gateways on your machine. Currently, it supports **Claude Code**, **Claude Desktop (Cowork + Code)**, the **OpenAI Codex CLI**, and the **Codex desktop app (macOS + Windows)**.
@@ -30,7 +30,9 @@ Pick your backend:
 | `relay-ai models` | Manage favorite models for mid-session `/model` switching |
 | `relay-ai server` | Foreground API gateway (registry providers + optional Zen/Go) |
 | `relay-ai server --vertex` | Foreground Anthropic-compatible gateway to Claude on Vertex AI |
+| `relay-ai claude-app` | Launch Claude Desktop app with registry providers ([guide](docs/CLAUDE_DESKTOP_SETUP.md)) |
 | `relay-ai codex` | Launch OpenAI Codex CLI with registry providers ([guide](docs/CODEX.md)) |
+| `relay-ai codex-app` | Launch Codex desktop app with registry providers ([guide](docs/CODEX.md)) |
 | `relay-ai --ai` | Full agent reference for scripts and alef-agent ([guide](docs/AI-AGENTS.md)) |
 
 Bare `relay-ai` prints help and migration guidance. Use `relay-ai claude` for the wizard.
@@ -80,14 +82,48 @@ Bare `relay-ai` prints help and migration guidance. Use `relay-ai claude` for th
 
 ## Installation
 
+To install the CLI globally:
+
 ```bash
-# Install globally
 npm install -g @jacobbd/relay-ai
+```
+
+### Upgrading
+
+To upgrade to the latest version:
 
-# Upgrade to the latest version
+```bash
 npm update -g @jacobbd/relay-ai
 ```
 
+### Uninstallation
+
+To uninstall the CLI globally:
+
+```bash
+npm uninstall -g @jacobbd/relay-ai
+```
+
+> [!NOTE]
+> If you use a Node version manager like **NVM**, make sure you run the uninstall command using the active Node version that was used to install it (e.g., run `nvm use <version>` first).
+
+To fully remove the tool and all its configuration data, you can delete the configuration directory (`.relay-ai`) on your operating system:
+
+- **macOS / Linux**:
+  ```bash
+  rm -rf ~/.relay-ai
+  ```
+- **Windows**:
+  - In Command Prompt:
+    ```cmd
+    rmdir /s /q "%USERPROFILE%\.relay-ai"
+    ```
+  - In PowerShell:
+    ```powershell
+    Remove-Item -Recurse -Force "$env:USERPROFILE\.relay-ai"
+    ```
+
+
 ## Setup
 
 ### Configure providers
@@ -317,7 +353,7 @@ Launch the **Codex app** (macOS or Windows) with registry providers:
 relay-ai codex-app
 ```
 
-Patches `~/.codex/config.toml` with backup; **Ctrl+C** in the relay-ai terminal restores your config. Tier 2 (Anthropic, etc.) requires keeping that terminal open. Preview config without writing: `relay-ai codex-app --config`. Recovery: `relay-ai codex-app --restore`.
+Patches `~/.codex/config.toml` with backup; **Ctrl+C** in the relay-ai terminal restores your config. The app keeps Codex's built-in `openai` provider active so existing conversation history remains visible, and routes the selected model through a foreground local proxy. Preview config without writing: `relay-ai codex-app --config`. Recovery: `relay-ai codex-app --restore`.
 
 See **[docs/CODEX.md](docs/CODEX.md)** for CLI vs app differences, file ownership, and troubleshooting.