@cmflow/agents 3.4.0-beta.33 → 3.4.0-beta.35

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,8 +55,13 @@ 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:
@@ -82,7 +87,7 @@ If `cm-agents check` reports that `npm -v` cannot run because a manually install
 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.
+This installs mise with winget when needed, installs Node.js 24 through mise, adds `%LOCALAPPDATA%\mise\shims` and the active `%LOCALAPPDATA%\mise\installs\node\<version>` directory to the user PATH, and removes legacy `nodejs` entries from that PATH.
 
 ```bash
 npx -p @cmflow/agents cm-agents check
@@ -144,64 +149,52 @@ 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
+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'
+
+# Update an existing Kibana profile and re-register the MCP
+cm-agents kibana setup --profile production --url https://api.clubmed.com/logs --user User --config sources.prod.json --reinstall
 ```
 
-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
-```
-
-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