@cmflow/agents 3.4.0-beta.32 → 3.4.0-beta.34

package/README.md

@@ -38,7 +38,7 @@ npx -p @cmflow/agents cm-agents install
 
 ## Commands
 
-### `cm-agents install [--reinstall]`
+### `cm-agents install`
 
 Interactive full workstation setup:
 
@@ -55,13 +55,19 @@ Interactive full workstation setup:
 ```bash
 npx -p @cmflow/agents cm-agents install
 npx -p @cmflow/agents cm-agents install --reinstall   # force reinstall of every tool
+npx -p @cmflow/agents cm-agents install --dryRun       # display every planned task without changes
+npx -p @cmflow/agents cm-agents install --agent codex  # configure Codex only
+npx -p @cmflow/agents cm-agents install --agent claude --mcps-only
 ```
 
+`--mcps-only` requires `--agent claude` or `--agent codex`. The Codex setup displays separate tasks for the CLI, LiteLLM model catalog, and LiteLLM configuration.
+
 ### `cm-agents check`
 
 Checks the workstation installation state and prints a pass / warn / fail report:
 
 - **Node.js version** ≥ 20 (via `process.version`)
+- **npm** can execute (`npm -v`)
 - **git**, **codex**, **claude** present in PATH
 - **python** present in PATH (optional — warn only)
 - Required environment variables
@@ -71,7 +77,17 @@ Checks the workstation installation state and prints a pass / warn / fail report
 - Claude MCPs configured
 - Repository cloned
 
-> `mise` and `node` are not checked for presence — they are prerequisites to run this CLI at all.
+> `cm-agents` itself requires Node.js to start. The `check` command also validates that `npm -v` can execute.
+
+### Repair Node.js on Windows
+
+If `cm-agents check` reports that `npm -v` cannot run because a manually installed Node.js binary has a bad signature, repair the user installation with:
+
+```powershell
+cm-agents node reinstall
+```
+
+This installs mise with winget when needed, installs Node.js 24 through mise, adds `%LOCALAPPDATA%\mise\shims` to the user PATH, and removes legacy `nodejs` entries from that PATH.
 
 ```bash
 npx -p @cmflow/agents cm-agents check
@@ -80,6 +96,7 @@ npx -p @cmflow/agents cm-agents check
 ### `cm-agents codex use openai [--model <model>]`
 
 Switches Codex back to the personal OpenAI account:
+
 - Removes `model_provider`, `model_catalog_json`, `model_providers`, `openai_base_url`
 - Lists available models via the OpenAI SDK (`openai.models.list()`) and shows an interactive select prompt
 - Falls back to `gpt-5.6-luna` if `OPENAI_API_KEY` is not set or the API is unreachable
@@ -92,6 +109,7 @@ cm-agents codex use openai --model gpt-5.6-luna     # skip selection
 ### `cm-agents codex use litellm`
 
 Switches Codex to the Club Med LiteLLM provider:
+
 - If `model_providers.litellm` is not yet configured, prompts for `LITELLM_API_KEY` and `base_url` (default: `https://litellm-aiplatform.ai.clubmed.com`)
 - Fetches the Club Med model catalog from the LiteLLM API → writes `~/.codex/clubmed-models.json`
 - Sets `model_provider = "litellm"`, `model_catalog_json`, and `model_providers.litellm`
@@ -131,71 +149,59 @@ Requires `LITELLM_API_KEY` to be set in the environment.
 cm-agents codex models --refresh
 ```
 
-### `cm-agents kibana setup <profile>`
+### `cm-agents kibana setup`
 
-Runs the interactive Kibana MCP profile setup wizard for the given profile name (`prod`, `staging`, or any custom name).
+Creates or updates a Kibana MCP profile. `cm-agents` collects the configuration values and securely prompts for the password, then provides them to the Kibana setup command.
 
-- Streams `npx @havesomecode/kibana-mcp-server setup` with full stdin/stdout relay.
 - After a successful setup, registers `kibana_<profile>` as a **stdio MCP** in both Codex and Claude.
 
 ```bash
-cm-agents kibana setup prod
-cm-agents kibana setup staging
-cm-agents kibana setup prod --reinstall   # re-register even if already present
-```
-
-Once a profile is configured, the MCP server is started on demand:
-
-```bash
-KIBANA_PROFILE=prod    npx -y @havesomecode/kibana-mcp-server serve
-KIBANA_PROFILE=staging npx -y @havesomecode/kibana-mcp-server serve
+cm-agents kibana setup \
+  --profile production \
+  --url https://api.clubmed.com/logs \
+  --user User \
+  --config 'SHARED_AGENTS_REPO_DIR/scripts/kibana-mcp-server/sources.{profile}.json'
+
+# Re-register the MCP even if already present
+cm-agents kibana setup --profile production --url https://api.clubmed.com/logs --user User --config sources.prod.json --reinstall
 ```
 
-The registered MCP JSON (used for both Codex and Claude):
-
-```json
-{
-  "type": "stdio",
-  "command": "npx",
-  "args": ["-y", "@havesomecode/kibana-mcp-server", "serve"],
-  "env": { "KIBANA_PROFILE": "prod" }
-}
-```
+`--config` supports `{profile}` and the literal `SHARED_AGENTS_REPO_DIR/` prefix. The prefix is resolved from the environment variable; when it is absent, `cm-agents` uses the first detected default repository directory.
 
 ### `cm-agents kibana serve <profile>`
 
 Starts the Kibana MCP server for a given profile — a thin proxy for:
 
 ```bash
-KIBANA_PROFILE=<profile> npx -y @havesomecode/kibana-mcp-server serve
+KIBANA_PROFILE=<profile> npx --yes --package=@havesomecode/kibana-mcp-server kibana-mcp-server serve
 ```
 
 ```bash
-cm-agents kibana serve prod
-cm-agents kibana serve staging
+cm-agents kibana serve --profile production
+cm-agents kibana serve --profile staging
 ```
 
 ## Environment variables
 
-| Variable                         | Purpose                                          |
-|----------------------------------|--------------------------------------------------|
-| `LITELLM_API_KEY`                | LiteLLM key (AI portal — VPN required)           |
-| `ANTHROPIC_API_KEY`              | Anthropic key (same portal)                      |
-| `ANTHROPIC_BASE_URL`             | LiteLLM proxy base URL                           |
-| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Default Claude model                             |
-| `ANTHROPIC_DEFAULT_FABLE_MODEL`  | Fable model                                      |
-| `ANTHROPIC_DEFAULT_OPUS_MODEL`   | Opus model                                       |
-| `ANTHROPIC_DEFAULT_HAIKU_MODEL`  | Haiku model                                      |
-| `CLUBMED_API_MCP_KEY`            | Club Med API portal MCP key                      |
-| `CMS_API_MCP_TOKEN`              | CMS Directus MCP token (optional)                |
-| `CLUBMED_REPO_DIR`               | Path to the `digital-api-team-skills` repository |
+| Variable                         | Purpose                                                   |
+| -------------------------------- | --------------------------------------------------------- |
+| `LITELLM_API_KEY`                | LiteLLM key (AI portal — VPN required)                    |
+| `ANTHROPIC_API_KEY`              | Anthropic key (same portal)                               |
+| `ANTHROPIC_BASE_URL`             | LiteLLM proxy base URL                                    |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Default Claude model                                      |
+| `ANTHROPIC_DEFAULT_FABLE_MODEL`  | Fable model                                               |
+| `ANTHROPIC_DEFAULT_OPUS_MODEL`   | Opus model                                                |
+| `ANTHROPIC_DEFAULT_HAIKU_MODEL`  | Haiku model                                               |
+| `CLUBMED_API_MCP_KEY`            | Club Med API portal MCP key                               |
+| `CMS_API_MCP_TOKEN`              | CMS Directus MCP token (optional)                         |
+| `SHARED_AGENTS_REPO_DIR`         | Optional path to the `digital-api-team-skills` repository |
 
 ## Configured MCPs
 
 ### Codex (`~/.codex/config.toml`)
 
 | Name          | URL                                       |
-|---------------|-------------------------------------------|
+| ------------- | ----------------------------------------- |
 | `clubmed_api` | `https://portal.api.clubmed/mcp`          |
 | `cms_api`     | `https://cms.api.clubmed/mcp`             |
 | `atlassian`   | `https://mcp.atlassian.com/v1/mcp/authv2` |
@@ -203,7 +209,7 @@ cm-agents kibana serve staging
 ### Claude (user scope)
 
 | Name          | URL                                                    |
-|---------------|--------------------------------------------------------|
+| ------------- | ------------------------------------------------------ |
 | `clubmed_api` | `https://portal.api.clubmed/mcp`                       |
 | `cms_api`     | `https://cms.api.clubmed/mcp`                          |
 | `atlassian`   | Marketplace plugin `atlassian@claude-plugins-official` |
@@ -215,7 +221,6 @@ cm-agents kibana serve staging
 3. Install the ChatGPT app (Codex UI): <https://chatgpt.com/download>
 4. Install Claude Desktop: <https://claude.ai/download>
 
-
 ## License
 
 The MIT License (MIT)