Skip to content

fix(init): skip MCP registration when client CLI is not on PATH - #118

Open
syf2211 wants to merge 1 commit into
mathomhaus:mainfrom
syf2211:fix/init-skip-missing-cli-on-path
Open

fix(init): skip MCP registration when client CLI is not on PATH#118
syf2211 wants to merge 1 commit into
mathomhaus:mainfrom
syf2211:fix/init-skip-missing-cli-on-path

Conversation

@syf2211

@syf2211 syf2211 commented Aug 22, 2026

Copy link
Copy Markdown

Summary

guild init now skips MCP registration for clients detected only via their config file when the corresponding CLI binary is not on PATH, and surfaces that skip in the init plan summary.

Motivation

Issue #48 fixed the --run path in guild mcp install to skip clients whose install CLI is missing from PATH. guild init still listed config-detected clients as pending registration in the plan, which misled users and could lead to opaque exec failures. Fixes #90.

Changes

  • Add CLIOnPath() and partitionCallableClients() in internal/install/clients.go
  • In guild init, partition detected clients and show skipping <client>: <binary> not on PATH in the plan
  • Pass only callable clients to MCPInstall; avoid the no-client hint when clients were detected but skipped
  • Add regression test for config-only detection without CLI on PATH

Tests

go test ./internal/install/... -count=1

All install package tests pass.

Notes

  • Pure-config clients (empty CLIProbe) remain unaffected
  • Skip wording matches guild mcp install --run (not on PATH)

Guild init previously showed config-detected clients in the plan and
attempted MCP registration even when the client's CLI binary was missing
from PATH. The --run path in MCPInstall already skipped these clients,
but the init summary did not surface the skip reason upfront.

Partition detected clients into callable vs config-only, show a clear
skip line in the init plan, and pass only callable clients to MCPInstall.
Avoid the misleading no-client hint when clients were detected but skipped.

Fixes mathomhaus#90
@github-actions github-actions Bot added the area: install guild init / mcp install / release label Aug 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: install guild init / mcp install / release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[bug] guild init should skip detected clients whose CLI binary is not on PATH

1 participant