@agent-native/core 0.49.4 → 0.49.6

package/docs/content/plan-plugin.md

@@ -23,11 +23,13 @@ long-lived (30-day default, sliding 365-day refresh), so this should be rare;
 when it happens, the lightweight fix is:
 
 ```bash
-npx -y @agent-native/core@latest reconnect https://plan.agent-native.com
+npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex
 ```
 
-`reconnect` finds and refreshes the connector by URL — no reinstall needed. In
-Claude Code, the equivalent is `/mcp` → **Authenticate / Reconnect**.
+`reconnect` finds and refreshes the connector by URL for the selected local
+client — no reinstall needed. Start a new Codex thread after reconnecting so the
+tool registry reloads. In Claude Code, the equivalent is `/mcp` →
+**Authenticate / Reconnect**, or the same command with `--client claude-code`.
 
 The exception is explicit **local-files privacy mode**. When you ask for no DB
 writes or set `AGENT_NATIVE_PLANS_MODE=local-files`, the skills must not call
@@ -56,7 +58,7 @@ There are three ways in. The **universal CLI route** is the one we recommend by
 
 ### Universal skill route (any MCP host) {#universal}
 
-Works for any host — Claude Code, Codex, Cursor, Cline, Goose, ChatGPT custom MCP apps, Claude Cowork, and anything else MCP-compatible. The Agent-Native CLI installs both skills, registers the hosted Plan MCP connector, **and authenticates it in the same step**, so your first tool call does not hit an OAuth wall:
+Works for any host — Claude Code, Codex, Cursor, Cline, Goose, ChatGPT custom MCP apps, Claude Cowork, and anything else MCP-compatible. The Agent-Native CLI installs both skills, registers the hosted Plan MCP connector, **and runs auth for the selected local client(s) in the same step**, so your first tool call does not hit an OAuth wall:
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan
@@ -64,8 +66,8 @@ npx @agent-native/core@latest skills add visual-plan
 
 This installs `visual-plan` plus the companion `visual-recap` skill, then registers the `plan` connector, then runs auth (OAuth prompt for hosted/account-backed sharing). Useful flags:
 
-- `--client codex|claude-code|claude-code-cli|cowork|all` — which local agents to write the MCP config for (default `codex`).
-- `--no-connect` — register the connector without authenticating; run `npx @agent-native/core@latest connect https://plan.agent-native.com` later.
+- `--client codex|claude-code|claude-code-cli|cowork|all` — which local agents to write the MCP config for (default `all`).
+- `--no-connect` — register the connector without authenticating; run `npx @agent-native/core@latest connect https://plan.agent-native.com --client all` later, or choose a narrower `--client`.
 - `--mcp-url <url>` — point the connector at a custom origin (an ngrok tunnel, a local dev server, or a self-hosted deployment) instead of the hosted default.
 - `--with-github-action` — also write the PR Visual Recap GitHub Action (see [PR Visual Recap](/docs/pr-visual-recap)).
 
@@ -84,7 +86,7 @@ access, and required Actions configuration. After install finishes, restart or
 reload the agent client so the new skills and tools load, then run
 `/visual-plan`.
 
-> Note: the bare `npx skills add BuilderIO/agent-native --skill visual-plan` (Vercel/open Skills CLI) installs **instructions only** — it does not register the MCP connector. Use the Agent-Native CLI above when you want the connector wired up too.
+> Note: the bare `npx skills@latest add BuilderIO/agent-native --skill visual-plan` (Vercel/open Skills CLI) installs **instructions only** — it does not register the MCP connector. Use the Agent-Native CLI above when you want the connector wired up too.
 
 ### Claude Code (plugin) {#claude-code}
 
@@ -113,7 +115,7 @@ codex mcp login plan   # OAuth in the browser
 
 After install, **start a new Codex thread** so the skills and MCP tools load into the session. The plugin ships a URL-only connector (`[mcp_servers.plan]` → `https://plan.agent-native.com/_agent-native/mcp`); `codex mcp login plan` runs the OAuth flow. The universal CLI route above also works for Codex (`npx @agent-native/core@latest skills add visual-plan --client codex`) if you prefer one command that installs and authenticates together.
 
-> **Older installs:** if your config still has an `agent-native-plans` entry pointing at the same URL, running `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com` (or `skills add visual-plan` for a full reinstall) consolidates it to the canonical `plan` name.
+> **Older installs:** if your config still has an `agent-native-plans` entry pointing at the same URL, running `npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex` for Codex, or the same command with your target `--client`, consolidates it to the canonical `plan` name.
 
 ## Updates {#updates}
 

package/docs/content/skills-guide.md

@@ -216,7 +216,7 @@ npx @agent-native/core@latest skills add visual-plan
 npx @agent-native/core@latest skills add assets
 
 # Vercel/open Skills CLI: exported instructions only, no MCP config.
-npx skills add BuilderIO/agent-native --skill assets
+npx skills@latest add BuilderIO/agent-native --skill assets
 
 # Register a hosted MCP connector for local agent clients.
 npx @agent-native/core@latest app-skill ensure --manifest templates/assets/agent-native.app-skill.json
@@ -229,7 +229,7 @@ npx @agent-native/core@latest app-skill launch --manifest templates/assets/agent
 npx @agent-native/core@latest app-skill pack --manifest templates/assets/agent-native.app-skill.json --out ./dist/assets-skill
 
 # Install a local exported bundle with the Vercel/open Skills CLI.
-npx skills add ./dist/assets-skill --skill assets -a codex -y
+npx skills@latest add ./dist/assets-skill --skill assets -a codex -y
 
 # Add the generated Claude Code marketplace, then install its Assets plugin.
 claude plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace
@@ -241,7 +241,7 @@ metadata; OAuth/device setup happens in the MCP host or through the app's normal
 settings flow.
 
 The Vercel Labs `skills` adapter is a portable `skills/<name>/SKILL.md` bundle
-for `npx skills add ...`, but the raw `skills` CLI installs instructions only.
+for `npx skills@latest add ...`, but the raw `skills` CLI installs instructions only.
 It does not run repo-defined postinstall scripts or register MCP connectors.
 Keep the Agent Native CLI as the default docs path for local agents because it
 also registers the MCP connector. `BuilderIO/agent-native` is a real GitHub

package/docs/content/template-assets.md

@@ -60,7 +60,7 @@ Generate and pick brand media without leaving Codex, Claude Code, Claude, or Cha
    Skills CLI, use:
 
    ```bash
-   npx skills add BuilderIO/agent-native --skill assets
+   npx skills@latest add BuilderIO/agent-native --skill assets
    ```
 
    The Vercel/open Skills CLI installs the instruction file only; it does not
@@ -181,7 +181,7 @@ The Assets app skill has app id `assets` and hosted MCP URL
 npx @agent-native/core@latest skills add assets
 
 # Vercel/open Skills CLI install: exported instructions only, no MCP config.
-npx skills add BuilderIO/agent-native --skill assets
+npx skills@latest add BuilderIO/agent-native --skill assets
 
 # Hosted install: URL-only MCP connector, no shared secrets in skill files.
 npx @agent-native/core@latest app-skill ensure --manifest templates/assets/agent-native.app-skill.json
@@ -193,7 +193,7 @@ npx @agent-native/core@latest app-skill launch --manifest templates/assets/agent
 npx @agent-native/core@latest app-skill pack --manifest templates/assets/agent-native.app-skill.json --out ./dist/assets-skill
 
 # Install a local exported Assets bundle with the open skills CLI.
-npx skills add ./dist/assets-skill --skill assets -a codex -y
+npx skills@latest add ./dist/assets-skill --skill assets -a codex -y
 
 # Install from the generated Claude Code marketplace adapter.
 claude plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace
@@ -211,7 +211,7 @@ as `/plugin marketplace add ./dist/assets-skill/adapters/claude-marketplace`,
 `/plugin install agent-native-assets@agent-native-apps`, `/reload-plugins`, and
 `/mcp` for MCP authentication.
 
-If you install from a raw marketplace bundle with `npx skills`, register the
+If you install from a raw marketplace bundle with `npx skills@latest`, register the
 hosted MCP connector so those instructions can call the live Assets app:
 
 ```bash

package/docs/content/template-plan.md

@@ -54,15 +54,17 @@ step does depends on your client:
 - In a **non-interactive shell or CI**, the auth step is skipped and the exact
   command to run later is printed for you.
 
-By default the CLI targets Codex. Add `--client claude-code` or `--client all`
-when you want to configure another host:
+By default the CLI targets every supported local client it can configure. Pass
+`--client codex`, `--client claude-code`, or another specific client when you
+want to narrow setup to one host:
 
 ```bash
-npx @agent-native/core@latest skills add visual-plan --client all
+npx @agent-native/core@latest skills add visual-plan
 ```
 
 Pass `--no-connect` to register the connector without authenticating, then run
-`npx @agent-native/core@latest connect https://plan.agent-native.com` whenever you are ready:
+`npx @agent-native/core@latest connect https://plan.agent-native.com --client all`
+whenever you are ready, or choose a narrower `--client`:
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan --no-connect
@@ -84,7 +86,7 @@ to verify the repo is ready.
 If you only want the portable instruction file through the open Skills CLI, use:
 
 ```bash
-npx skills add BuilderIO/agent-native --skill visual-plan
+npx skills@latest add BuilderIO/agent-native --skill visual-plan
 ```
 
 That installs the skill instructions only. It does not register the hosted MCP
@@ -243,9 +245,10 @@ of the hosted database.
 
 If a Plans tool ever returns `needs auth`, `Unauthorized`, or `Session
 terminated`, do not keep retrying it. Authenticate the connector with
-`npx @agent-native/core@latest connect https://plan.agent-native.com` (or re-run `/mcp` →
-**Authenticate** in an OAuth-capable host), then continue once the connector is
-available.
+`npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`
+for Codex, or re-run `/mcp` → **Authenticate** in an OAuth-capable host. Start a
+new Codex thread or restart/reload the relevant client before expecting the tool
+registry to update.
 
 ## For developers
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.49.4",
+  "version": "0.49.6",
   "type": "module",
   "engines": {
     "node": ">=22"
@@ -218,7 +218,6 @@
     "pako": "^2.1.0",
     "prettier": "^3.8.3",
     "react-markdown": "^10.1.0",
-    "react-router": "^7.16.0",
     "recharts": "^3.8.1",
     "remark-gfm": "^4.0.1",
     "roughjs": "4.6.6",