Skip to content

feat: add kody install for running local MCP clients - #2

Merged
kody-bot merged 2 commits into
mainfrom
cursor/cli-install-hosts-3bb9
Aug 21, 2026
Merged

feat: add kody install for running local MCP clients#2
kody-bot merged 2 commits into
mainfrom
cursor/cli-install-hosts-3bb9

Conversation

@kody-bot

Copy link
Copy Markdown
Owner

What

Adds kody install (not setup) so the official CLI can configure locally running MCP agents.

Why

People should be able to point Cursor, Claude Desktop, VS Code, Goose, and similar local hosts at https://kody.codes/mcp without hand-editing every vendor file. Web clients stay on kody.codes/onboarding.

Behavior

  • Detects currently running local agents (ps-list) and offers a TTY checkbox (all pre-checked).
  • --yes installs every detected host; --clients can target a host that is not running.
  • Rejects web ids (chatgpt, claude.ai, grok) and points at /onboarding.
  • Writes common host configs through add-mcp upsertServer.
  • Prefers vendor CLIs when present (claude / copilot / gemini mcp add).
  • Claude Desktop is Connectors-UI only — no claude_desktop_config.json write.
  • After success, prints a copy-paste prompt the user can give their agent to continue onboarding.

Hosts

Local only: Cursor, VS Code / Insiders, Visual Studio, Claude Desktop, Claude Code, Codex, Copilot CLI, Gemini CLI, Goose, Windsurf, Zed, OpenCode, Cline / Cline CLI, Antigravity, JetBrains, Amazon Q, Qwen Code, Grok Build (CLI), mcporter.

Out of scope

  • No change to kody.codes /onboarding.
  • kody install does not run kody login or paste CLI tokens into host configs.

Test plan

  • npm run validate locally (typecheck, tests, build)
  • npx @kodycodes/cli install with a running local agent after publish
  • Confirm Claude Desktop stays instruction-only
  • Confirm web-client help sentence points at https://kody.codes/onboarding

Detect currently running local agents, write host MCP config through
add-mcp (plus leftover writers and vendor CLIs), skip web clients, and
print a copy-paste onboarding prompt. Claude Desktop stays Connectors-UI
only. Help points at kody.codes/onboarding for ChatGPT, Claude.ai, and Grok.
@kody-bot
kody-bot marked this pull request as ready for review August 21, 2026 07:00
@kody-bot
kody-bot merged commit 560fdc6 into main Aug 21, 2026
5 checks passed
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.1.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant