@cmflow/agents 3.7.1 → 3.8.1

package/README.md

@@ -49,7 +49,7 @@ Interactive full workstation setup:
 3. Clones / updates the `digital-api-team-skills` repository
 4. Writes environment variables to the shell rc (Unix) or user scope (Windows)
 5. Installs and configures **Codex CLI** (MCPs; LiteLLM config if chosen)
-6. Installs and configures **Claude CLI** (HTTP MCPs, Atlassian marketplace plugin)
+6. Installs and configures **Claude CLI** (HTTP MCPs, official Atlassian marketplace plugin) and **Claude Desktop** MCPs
 7. Optionally installs Python 3.12 via mise
 
 ```bash
@@ -74,7 +74,7 @@ Checks the workstation installation state and prints a pass / warn / fail report
 - Codex config (`~/.codex/config.toml` + standard MCPs)
 - **Codex LiteLLM provider**: `model_provider = "litellm"`, correct `base_url`, `model_catalog_json` exists, active `model` is in the catalog
 - **Kibana MCPs**: warns if no `kibana_*` profile is configured in Codex
-- Claude MCPs configured
+- Claude CLI MCPs and Claude Desktop MCPs configured separately
 - Repository cloned
 
 > `cm-agents` itself requires Node.js to start. The `check` command also validates that `npm -v` can execute.
@@ -151,7 +151,7 @@ cm-agents codex models --refresh
 
 ### `cm-agents kibana setup`
 
-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.
+Creates or updates a Kibana MCP profile with the package's non-interactive `bootstrap` command. `cm-agents` collects the connection values, passes the URL, user, and profile as explicit CLI options, and provides the password only through the child process environment.
 
 - After a successful setup, registers `kibana_<profile>` as a **stdio MCP** in both Codex and Claude.
 
@@ -159,26 +159,25 @@ Creates or updates a Kibana MCP profile. `cm-agents` collects the configuration
 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'
+  --user User
 
-# 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
+# Re-register the MCP transport for an existing profile
+cm-agents kibana setup --profile production --url https://api.clubmed.com/logs --user User --reinstall
 ```
 
-`--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.
+The setup also installs the global Codex skill `kibana-log-investigation` with `npx skills add`. After bootstrap, use the MCP's `discover` tool and ask the user to name an exact Kibana index before calling `configure_index`.
 
 ### `cm-agents kibana serve <profile>`
 
 Starts the Kibana MCP server for a given profile — a thin proxy for:
 
 ```bash
-KIBANA_PROFILE=<profile> npx --yes --package=@havesomecode/kibana-mcp-server kibana-mcp-server serve
+npx --yes --package=@havesomecode/kibana-mcp-server kibana-mcp-server serve --profile <profile>
 ```
 
 ```bash
-cm-agents kibana serve --profile production
-cm-agents kibana serve --profile staging
+cm-agents kibana serve production
+cm-agents kibana serve staging
 ```
 
 ## Environment variables
@@ -206,7 +205,7 @@ cm-agents kibana serve --profile staging
 | `cms_api`     | `https://cms.api.clubmed/mcp`             |
 | `atlassian`   | `https://mcp.atlassian.com/v1/mcp/authv2` |
 
-### Claude (user scope)
+### Claude CLI (user scope)
 
 | Name          | URL                                                    |
 | ------------- | ------------------------------------------------------ |
@@ -214,6 +213,16 @@ cm-agents kibana serve --profile staging
 | `cms_api`     | `https://cms.api.clubmed/mcp`                          |
 | `atlassian`   | Marketplace plugin `atlassian@claude-plugins-official` |
 
+### Claude Desktop
+
+`cm-agents install` merges the Club Med MCP entries into `claude_desktop_config.json` without replacing existing Desktop preferences:
+
+- macOS: `~/Library/Application Support/Claude-3p/claude_desktop_config.json`
+- Windows: `%USERPROFILE%\AppData\Local\Claude-3p\claude_desktop_config.json`
+
+The Desktop configuration includes `context-mode`, `clubmed_api`, `cms_api`, and `cms_api_staging`.
+The Atlassian marketplace plugin is shared with Claude CLI through `~/.claude/settings.json`, rather than `Claude-3p`.
+
 ## Post-install manual steps
 
 1. Restart the terminal to load environment variables