summer-engine 3.0.0 → 3.1.0

package/dist/installer/skill-locations.js

@@ -3,12 +3,15 @@
  *
  * Lives in the installer layer (not cli/) so `summer setup` can report the
  * destination and count without importing the CLI (import-direction contract
- * §2: shared layers never import cli or mcp).
+ * §2: shared layers never import cli or mcp). The per-agent paths come from
+ * the one agent table (agent-table.ts); only the `summer` pseudo-client is
+ * resolved here.
  */
 import { join } from "path";
-import { homedir, platform } from "os";
+import { homedir } from "os";
 import { AGENT_CLIENTS } from "../core/skills-registry.js";
 import { tildeify } from "../core/format.js";
+import { agentSpec, defaultPathContext, resolveSkillPath, } from "./agent-table.js";
 export const SKILL_SCOPES = ["user", "project"];
 function isAgentClient(value) {
     return AGENT_CLIENTS.includes(value);
@@ -44,114 +47,32 @@ export function resolveSkillAgent(opts) {
     }
     return parseSkillAgent(opts.agent ?? legacyAgent ?? "summer");
 }
-/** Explicit --scope wins; otherwise project-rooted agents default to "project". */
+/** Explicit --scope wins; otherwise the agent's default (rule-file agents default to "project"). */
 export function resolveSkillScope(agent, opts) {
     if (opts.scope)
         return parseSkillScope(opts.scope);
-    if (agent === "cursor" ||
-        agent === "windsurf" ||
-        agent === "cline" ||
-        agent === "roo-code" ||
-        agent === "kilo-code") {
-        return "project";
-    }
-    return "user";
+    if (agent === "summer")
+        return "user";
+    return agentSpec(agent).skills?.defaultScope ?? "user";
 }
 export function resolveInstallLocation(agent, scope) {
     const overrideDir = process.env.SUMMER_SKILLS_DIR;
-    if (overrideDir) {
-        if (agent === "cursor")
-            return { kind: "cursor-rule-dir", path: overrideDir };
-        if (agent === "windsurf") {
-            return { kind: "windsurf-rule-file", path: join(overrideDir, ".windsurfrules") };
-        }
-        if (agent === "cline" || agent === "roo-code" || agent === "kilo-code") {
-            return { kind: "cline-rule-dir", path: overrideDir };
-        }
-        if (agent === "gemini") {
-            return { kind: "skill-dir", path: overrideDir };
-        }
-        if (agent === "opencode") {
-            return { kind: "opencode-skill-dir", path: overrideDir };
-        }
-        return { kind: "skill-dir", path: overrideDir };
+    if (agent === "summer") {
+        const root = scope === "user" ? homedir() : process.cwd();
+        return { kind: "skill-dir", path: overrideDir ?? join(root, ".summer", "skills") };
     }
-    const root = scope === "user" ? homedir() : process.cwd();
-    switch (agent) {
-        case "codex":
-            return { kind: "skill-dir", path: join(root, ".agents", "skills") };
-        case "claude-code":
-            return { kind: "skill-dir", path: join(root, ".claude", "skills") };
-        case "cursor":
-            return { kind: "cursor-rule-dir", path: join(root, ".cursor", "rules") };
-        case "windsurf":
-            return { kind: "windsurf-rule-file", path: join(root, ".windsurfrules") };
-        case "cline":
-            return {
-                kind: "cline-rule-dir",
-                path: scope === "user"
-                    ? clineUserRulesDir()
-                    : join(process.cwd(), ".clinerules"),
-            };
-        case "roo-code":
-            return {
-                kind: "cline-rule-dir",
-                path: scope === "user"
-                    ? rooCodeUserRulesDir()
-                    : join(process.cwd(), ".clinerules"),
-            };
-        case "kilo-code":
-            return {
-                kind: "cline-rule-dir",
-                path: scope === "user"
-                    ? join(homedir(), ".kilocode", "rules")
-                    : join(process.cwd(), ".kilocode", "rules"),
-            };
-        case "gemini":
-            // Gemini discovers extension skills from <extension>/skills/<name>/SKILL.md
-            // (geminicli.com/docs/extensions/reference), so copy the skill directories
-            // as-is. The extension dir itself is written by `summer setup gemini`.
-            return {
-                kind: "skill-dir",
-                path: join(homedir(), ".gemini", "extensions", "summer-engine", "skills"),
-            };
-        case "github-copilot":
-        case "vscode-copilot":
-            return {
-                kind: "skill-dir",
-                path: scope === "user"
-                    ? join(homedir(), ".copilot", "skills")
-                    : join(process.cwd(), ".github", "skills"),
-            };
-        case "opencode":
-            return {
-                kind: "opencode-skill-dir",
-                path: scope === "user"
-                    ? opencodeUserAgentsDir()
-                    : join(process.cwd(), ".opencode", "agents", "summer"),
-            };
-        case "summer":
-            return { kind: "skill-dir", path: join(root, ".summer", "skills") };
+    const spec = agentSpec(agent);
+    const resolved = resolveSkillPath(spec, scope, defaultPathContext());
+    if (!resolved) {
+        throw new Error(`${spec.label} has no skills folder. ${spec.noSkillsNote ?? ""}`.trim());
     }
-}
-function clineUserRulesDir() {
-    // Cline reads global rules from the user's Documents/Cline/Rules folder.
-    return join(homedir(), "Documents", "Cline", "Rules");
-}
-function rooCodeUserRulesDir() {
-    // Roo Code reads global rules from the user's Documents/Roo/Rules folder.
-    return join(homedir(), "Documents", "Roo", "Rules");
-}
-function opencodeUserAgentsDir() {
-    // OpenCode's user-scope agent definition directory varies by OS.
-    // On Windows, OpenCode reads from %APPDATA%/opencode/agents/summer.
-    // On Linux/macOS, it reads from $XDG_CONFIG_HOME or ~/.config/opencode/agents/summer.
-    if (platform() === "win32") {
-        const appData = process.env.APPDATA ?? join(homedir(), "AppData", "Roaming");
-        return join(appData, "opencode", "agents", "summer");
+    if (overrideDir) {
+        return {
+            kind: resolved.kind,
+            path: resolved.kind === "windsurf-rule-file" ? join(overrideDir, ".windsurfrules") : overrideDir,
+        };
     }
-    const xdg = process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
-    return join(xdg, "opencode", "agents", "summer");
+    return { kind: resolved.kind, path: resolved.path };
 }
 /** One-line, human path pattern for where an install location puts skills. */
 export function describeInstallLocation(location) {

package/dist/installer/version-check.d.ts

@@ -11,6 +11,7 @@
  * Both are designed to be silent on offline / network errors — we never want
  * to false-alarm a user just because their wifi is flaky.
  */
+import { type McpFormat } from "./agent-table.js";
 import { type StdioMcpServerConfig } from "./agent-config.js";
 export interface SemverParts {
     major: number;
@@ -145,10 +146,13 @@ export declare function isLocalDevServerConfig(server: StdioMcpServerConfig): bo
  *   json-copilot   {"mcpServers": {"summer-engine": {type, command, args}}}
  *   json-vscode    {"servers":    {"summer-engine": {type, command, args}}}
  *   json-opencode  {"mcp":        {"summer-engine": {type, command: [cmd, ...args]}}}
+ *   json-zed       {"context_servers": {"summer-engine": {source, command, args}}}
+ *   yaml-goose     extensions: summer-engine: {cmd, args}
+ *   yaml-hermes    mcp_servers: summer-engine: {command, args}
  *   toml (codex)   [mcp_servers.summer-engine]\ncommand = "…"\nargs = ["…", …]
  * Returns null when the file is missing, unparsable, or has no Summer entry.
  */
-export declare function readRecordedMcpServer(text: string, format: "json" | "toml" | "json-opencode" | "json-copilot" | "json-vscode"): StdioMcpServerConfig | null;
+export declare function readRecordedMcpServer(text: string, format: McpFormat): StdioMcpServerConfig | null;
 /** Is the CLI running this check a source checkout rather than an installed
  *  package? npm/npx/global installs all live under a node_modules directory. */
 export declare function runningCliIsCheckout(packageRoot?: string): boolean;

package/dist/installer/version-check.js

@@ -12,10 +12,11 @@
  * to false-alarm a user just because their wifi is flaky.
  */
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir, platform } from "node:os";
+import { parse as parseYaml } from "yaml";
+import { allAgentSpecs, defaultPathContext, resolveSkillPath } from "./agent-table.js";
 import { join, sep } from "node:path";
 import { PACKAGE_ROOT } from "../core/package-root.js";
-import { configureAgentMcp, parseAgent, SUMMER_MCP_SERVER_NAME, } from "./agent-config.js";
+import { configureAgentMcp, parseAgent, SUMMER_MCP_SERVER_NAME, topLevelKey, } from "./agent-config.js";
 const NPM_REGISTRY_LATEST_URL = "https://registry.npmjs.org/summer-engine/latest";
 const REGISTRY_FETCH_TIMEOUT_MS = 3000;
 export function parseSemver(version) {
@@ -197,32 +198,17 @@ export function writeSkillMarker(dir, version, now = new Date()) {
     return path;
 }
 export function defaultSkillMarkerCandidates() {
-    const home = homedir();
+    const ctx = defaultPathContext();
     const candidates = [
-        { agent: "claude-code", dir: join(home, ".claude", "skills") },
-        { agent: "codex", dir: join(home, ".agents", "skills") },
-        { agent: "summer", dir: join(home, ".summer", "skills") },
-        { agent: "cline", dir: join(home, "Documents", "Cline", "Rules") },
-        { agent: "roo-code", dir: join(home, "Documents", "Roo", "Rules") },
-        {
-            agent: "gemini",
-            dir: join(home, ".gemini", "extensions", "summer-engine", "skills"),
-        },
+        { agent: "summer", dir: join(ctx.home, ".summer", "skills") },
     ];
-    // OpenCode user-scope agent dir is OS-dependent.
-    if (platform() === "win32") {
-        const appData = process.env.APPDATA ?? join(home, "AppData", "Roaming");
-        candidates.push({
-            agent: "opencode",
-            dir: join(appData, "opencode", "agents", "summer"),
-        });
-    }
-    else {
-        const xdg = process.env.XDG_CONFIG_HOME ?? join(home, ".config");
-        candidates.push({
-            agent: "opencode",
-            dir: join(xdg, "opencode", "agents", "summer"),
-        });
+    // Every agent with a user-scope skills home, from the one agent table.
+    // Devin Desktop's single rules file has no dir to mark; skip that kind.
+    for (const spec of allAgentSpecs()) {
+        const home = resolveSkillPath(spec, "user", ctx);
+        if (!home || home.kind === "windsurf-rule-file")
+            continue;
+        candidates.push({ agent: spec.id, dir: home.path });
     }
     return candidates;
 }
@@ -362,12 +348,29 @@ export function isLocalDevServerConfig(server) {
  *   json-copilot   {"mcpServers": {"summer-engine": {type, command, args}}}
  *   json-vscode    {"servers":    {"summer-engine": {type, command, args}}}
  *   json-opencode  {"mcp":        {"summer-engine": {type, command: [cmd, ...args]}}}
+ *   json-zed       {"context_servers": {"summer-engine": {source, command, args}}}
+ *   yaml-goose     extensions: summer-engine: {cmd, args}
+ *   yaml-hermes    mcp_servers: summer-engine: {command, args}
  *   toml (codex)   [mcp_servers.summer-engine]\ncommand = "…"\nargs = ["…", …]
  * Returns null when the file is missing, unparsable, or has no Summer entry.
  */
 export function readRecordedMcpServer(text, format) {
     if (!text.trim())
         return null;
+    if (format === "toml-array") {
+        const block = text.match(new RegExp(`^\\[\\[mcp_servers\\]\\]\\s*$([\\s\\S]*?)(?=^\\[|(?![\\s\\S]))`, "gm"));
+        for (const candidate of block ?? []) {
+            if (!new RegExp(`^name\\s*=\\s*"${SUMMER_MCP_SERVER_NAME}"`, "m").test(candidate))
+                continue;
+            const command = candidate.match(/^command\s*=\s*"((?:[^"\\]|\\.)*)"/m)?.[1];
+            const argsText = candidate.match(/^args\s*=\s*\[([^\]]*)\]/m)?.[1] ?? "";
+            if (!command)
+                return null;
+            const args = [...argsText.matchAll(/"((?:[^"\\]|\\.)*)"/g)].map((m) => m[1].replace(/\\(.)/g, "$1"));
+            return { command: command.replace(/\\(.)/g, "$1"), args };
+        }
+        return null;
+    }
     if (format === "toml") {
         const table = text.match(new RegExp(`^\\[mcp_servers\\.${SUMMER_MCP_SERVER_NAME.replace(/[-.]/g, "\\$&")}\\]\\s*$([\\s\\S]*?)(?=^\\[|(?![\\s\\S]))`, "m"));
         if (!table)
@@ -381,7 +384,7 @@ export function readRecordedMcpServer(text, format) {
     }
     let parsed;
     try {
-        parsed = JSON.parse(text);
+        parsed = format === "yaml-goose" || format === "yaml-hermes" ? parseYaml(text) : JSON.parse(text);
     }
     catch {
         return null;
@@ -389,7 +392,9 @@ export function readRecordedMcpServer(text, format) {
     if (!parsed || typeof parsed !== "object")
         return null;
     const root = parsed;
-    for (const container of ["mcpServers", "servers", "mcp"]) {
+    // The format's own key first, then the other shapes (a user may have moved to a newer file layout).
+    const containers = [topLevelKey(format), "mcpServers", "servers", "mcp", "context_servers", "extensions", "mcp_servers", "amp.mcpServers"];
+    for (const container of [...new Set(containers)]) {
         const servers = root[container];
         if (!servers || typeof servers !== "object")
             continue;
@@ -397,6 +402,11 @@ export function readRecordedMcpServer(text, format) {
         if (!entry || typeof entry !== "object")
             continue;
         const record = entry;
+        if (typeof record.cmd === "string") {
+            // Goose: { cmd, args }
+            const args = Array.isArray(record.args) ? record.args.filter((part) => typeof part === "string") : [];
+            return { command: record.cmd, args };
+        }
         if (Array.isArray(record.command)) {
             const [command, ...args] = record.command.filter((part) => typeof part === "string");
             return command ? { command, args } : null;

package/gemini-extension.json

@@ -1,7 +1,7 @@
 {
   "_generated": "GENERATED from integrations/gemini — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Agent tooling for Summer Engine: MCP bridge, context primer, and game-dev skills. Use with the npm CLI for skill files on disk.",
   "contextFileName": "GEMINI.md",
   "mcpServers": {

package/integrations/README.md

@@ -2,10 +2,11 @@
 
 One folder per supported client. This directory is the single place that
 says which agents Summer supports and how each one consumes the library.
-Adding a new agent (e.g. Grok) = one folder here (plus, if it has a manifest
-file, a builder in `scripts/generate-registry/manifests.ts` and a target in
-`scripts/generate-registry/targets.ts`) + `npm run generate:registry` —
-never hand-editing root files.
+Adding a new agent = one row in `src/installer/agent-table.ts` + one folder
+here + an empty entry in `scripts/generate-registry/targets.ts` (plus, if it
+has a manifest file, a builder in `scripts/generate-registry/manifests.ts`) +
+`npm run generate:registry` — never hand-editing root files. Tests fail when
+the table, this directory, and targets.ts disagree.
 
 Each folder contains:
 
@@ -18,8 +19,8 @@ installs every skill (`skills install --all`, preview included; `--stable-only`
 skips preview) in the SAME scope,
 so a user-scope MCP config never ends up beside project-scope skills.
 `--scope project` moves both; `--recommended` installs only the recommended
-subset. Clients whose MCP config is user-only (cline, roo-code, lm-studio,
-gemini) fall back to user scope with a warning. `.mcp.json` at the repo root
+subset. Clients whose MCP config is user-only (see the table) fall back to user
+scope with a warning. `.mcp.json` at the repo root
 (the MCP pointer the claude / codex / cursor / factory manifests share) is
 generated too — `registry/generated/mcp.json -> .mcp.json`.
 - `manifest-target.json` — mapping of generated file -> repo-root destination
@@ -52,19 +53,47 @@ How the plugin manifests reference skills, and what is verified:
 
 | Client | Manifest generated in this repo | `summer setup` writes |
 |---|---|---|
-| claude | `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `.mcp.json` | MCP: `~/.claude.json` (user) / `.mcp.json` (project); skills: `~/.claude/skills/` (user) / `.claude/skills/` (project); slash commands from `commands/` to `~/.claude/commands/` |
-| codex | `.codex-plugin/plugin.json` | MCP: `~/.codex/config.toml` (TOML); skills: `.agents/skills/` |
-| cursor | `.cursor-plugin/plugin.json` | MCP: `~/.cursor/mcp.json` / `.cursor/mcp.json`; skills: `.cursor/rules/` |
-| factory | `.factory-plugin/plugin.json` | nothing — there is no `summer setup factory` target. Install via the plugin marketplace: `droid plugin marketplace add https://github.com/summerengine/summer` then `droid plugin install summer@summer-engine`. Factory reads MCP from the plugin's `.mcp.json` and skills only from a root `skills/` dir (this package ships them under `library/skills/`, so the manifest `skills` array is not read by Factory — open gap) |
-| gemini | `gemini-extension.json` | extension dir `~/.gemini/extensions/summer-engine/`: the generated manifest (renamed `summer-engine` to match the dir, MCP launcher swapped to `npx -y summer-engine@latest mcp`) + `GEMINI.md` + `AGENTS.md`; skills: `~/.gemini/extensions/summer-engine/skills/<slug>/SKILL.md` (Gemini extension-skill discovery; user scope only) |
-| windsurf (Devin Desktop) | — | MCP: `~/.codeium/windsurf/mcp_config.json`; rules: `.windsurfrules` |
-| cline | — | MCP: VS Code global storage (`saoudrizwan.claude-dev`); rules: `.clinerules` |
-| roo-code | — | MCP: VS Code global storage (`rooveterinaryinc.roo-cline`); rules: `.clinerules` |
-| kilo-code | — | MCP: VS Code global storage `kilocode.kilo-code/settings/mcp_settings.json` (user) / `.kilocode/mcp.json` (project); rules: `~/.kilocode/rules/` (user) / `.kilocode/rules/` (project) |
-| github-copilot | — | MCP: `~/.copilot/mcp-config.json` / `.mcp.json`; skills: `~/.copilot/skills/` or `.github/skills/` |
-| vscode-copilot | — | MCP: VS Code user-profile `mcp.json` / `.vscode/mcp.json`; skills: `~/.copilot/skills/` or `.github/skills/` |
-| opencode | — (JS plugin via npm `main`, `.opencode/plugins/summer.js`) | MCP entry in `opencode.json` (`type: "local"`, array `command`); skills: the plugin registers `library/skills/` via `skills.paths`; `skills install --agent opencode` additionally writes `agents/summer/` markdown |
-| lm-studio | — | MCP: `~/.lmstudio/mcp.json` (app-global); no skills folder — guidance via `summer_get_agent_playbook` |
+| claude | `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `.mcp.json` | MCP: `~/.claude.json`; Windows `%USERPROFILE%/.claude.json` / `.mcp.json`; skills: `~/.claude/skills` / `.claude/skills` (`<skill>/SKILL.md`) |
+| claude-desktop | — | MCP: `~/Library/Application Support/Claude/claude_desktop_config.json`; Linux `~/.config/Claude/claude_desktop_config.json`; Windows `%APPDATA%/Claude/claude_desktop_config.json`; no skills folder (MCP only) |
+| codex | `.codex-plugin/plugin.json` | MCP: `~/.codex/config.toml`; Windows `%USERPROFILE%/.codex/config.toml` / `.codex/config.toml`; skills: `~/.agents/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
+| cursor | `.cursor-plugin/plugin.json` | MCP: `~/.cursor/mcp.json`; Windows `%USERPROFILE%/.cursor/mcp.json` / `.cursor/mcp.json`; skills: `~/.cursor/skills` / `.cursor/skills` (`<skill>/SKILL.md`) |
+| windsurf | — | MCP: `~/.codeium/windsurf/mcp_config.json`; Windows `%USERPROFILE%/.codeium/windsurf/mcp_config.json`; skills: `~/.codeium/windsurf/skills` / `.windsurf/skills` (`<skill>/SKILL.md`) |
+| antigravity | — | MCP: `~/.gemini/config/mcp_config.json`; Windows `%USERPROFILE%/.gemini/config/mcp_config.json` / `.agents/mcp_config.json`; skills: `~/.gemini/config/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
+| gemini (legacy) | `gemini-extension.json` | MCP: `~/.gemini/extensions/summer-engine/gemini-extension.json`; Windows `%USERPROFILE%/.gemini/extensions/summer-engine/gemini-extension.json`; skills: `~/.gemini/extensions/summer-engine/skills` (`<skill>/SKILL.md`) |
+| cline | — | MCP: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; Linux `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; Windows `%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; skills: `~/.cline/skills` / `.cline/skills` (`<skill>/SKILL.md`) |
+| cline-cli | — | MCP: `~/.cline/data/settings/cline_mcp_settings.json`; Windows `%USERPROFILE%/.cline/data/settings/cline_mcp_settings.json`; skills: `~/.cline/skills` / `.cline/skills` (`<skill>/SKILL.md`) |
+| roo-code (legacy) | — | MCP: `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`; Linux `~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`; Windows `%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`; skills: `~/Documents/Roo/Rules` / `.clinerules` (rule files `summer-<skill>.md`) |
+| kilo-code | — | MCP: `~/.config/kilo/kilo.json`; Windows `%APPDATA%/kilo/kilo.json` / `kilo.json`; skills: `~/.kilo/skills` / `.kilo/skills` (`<skill>/SKILL.md`) |
+| github-copilot | — | MCP: `~/.copilot/mcp-config.json`; Windows `%USERPROFILE%/.copilot/mcp-config.json` / `.mcp.json`; skills: `~/.copilot/skills` / `.github/skills` (`<skill>/SKILL.md`) |
+| vscode-copilot | — | MCP: `~/Library/Application Support/Code/User/mcp.json`; Linux `~/.config/Code/User/mcp.json`; Windows `%APPDATA%/Code/User/mcp.json` / `.vscode/mcp.json`; skills: `~/.copilot/skills` / `.github/skills` (`<skill>/SKILL.md`) |
+| visual-studio | — | MCP: `~/.mcp.json`; Windows `%USERPROFILE%/.mcp.json` / `.mcp.json`; no skills folder (MCP only) |
+| copilot-jetbrains | — | MCP: `~/.config/github-copilot/intellij/mcp.json`; Windows `%APPDATA%/github-copilot/intellij/mcp.json`; no skills folder (MCP only) |
+| opencode | — | MCP: `~/.config/opencode/opencode.json`; Windows `%APPDATA%/opencode/opencode.json` / `opencode.json`; skills: `~/.config/opencode/skills` / `.opencode/skills` (`<skill>/SKILL.md`) |
+| zed | — | MCP: `~/.config/zed/settings.json`; Windows `%APPDATA%/zed/settings.json`; skills: `~/.agents/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
+| kiro | — | MCP: `~/.kiro/settings/mcp.json`; Windows `%USERPROFILE%/.kiro/settings/mcp.json` / `.kiro/settings/mcp.json`; skills: `~/.kiro/skills` / `.kiro/skills` (`<skill>/SKILL.md`) |
+| goose | — | MCP: `~/.config/goose/config.yaml`; Windows `%APPDATA%/Block/goose/config/config.yaml`; skills: `~/.config/agents/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
+| hermes | — | MCP: `~/.hermes/config.yaml`; Windows `%USERPROFILE%/.hermes/config.yaml`; skills: `~/.hermes/skills` / `.hermes/skills` (`<skill>/SKILL.md`) |
+| trae | — | MCP: `.trae/mcp.json` / `.trae/mcp.json`; no skills folder (MCP only) |
+| qwen-code | — | MCP: `~/.qwen/settings.json`; Windows `%USERPROFILE%/.qwen/settings.json` / `.qwen/settings.json`; skills: `~/.qwen/skills` / `.qwen/skills` (`<skill>/SKILL.md`) |
+| kimi-code | — | MCP: `~/.kimi-code/mcp.json`; Windows `%USERPROFILE%/.kimi-code/mcp.json` / `.kimi-code/mcp.json`; skills: `~/.kimi-code/skills` / `.kimi-code/skills` (`<skill>/SKILL.md`) |
+| crush | — | MCP: `~/.config/crush/crushrc`; Windows `%USERPROFILE%/.config/crush/crushrc` / `.crushrc`; skills: `~/.config/crush/skills` / `.crush/skills` (`<skill>/SKILL.md`) |
+| amp | — | MCP: `~/.config/amp/settings.json`; Windows `%APPDATA%/amp/settings.json`; skills: `~/.config/amp/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
+| factory | `.factory-plugin/plugin.json` | MCP: `~/.factory/mcp.json`; Windows `%USERPROFILE%/.factory/mcp.json` / `.factory/mcp.json`; skills: `~/.factory/skills` / `.factory/skills` (`<skill>/SKILL.md`) |
+| junie | — | MCP: `~/.junie/mcp/mcp.json`; Windows `%USERPROFILE%/.junie/mcp/mcp.json` / `.junie/mcp/mcp.json`; no skills folder (MCP only) |
+| warp | — | MCP: `~/.warp/.mcp.json`; Windows `%USERPROFILE%/.warp/.mcp.json` / `.warp/.mcp.json`; skills: `~/.warp/skills` / `.warp/skills` (`<skill>/SKILL.md`) |
+| rovo-dev | — | MCP: `~/.rovodev/mcp.json`; Windows `%USERPROFILE%/.rovodev/mcp.json`; skills: `~/.rovodev/skills` / `.rovodev/skills` (`<skill>/SKILL.md`) |
+| qoder | — | MCP: `~/.qoder/settings.json`; Windows `%USERPROFILE%/.qoder/settings.json` / `.mcp.json`; skills: `~/.qoder/skills` / `.qoder/skills` (`<skill>/SKILL.md`) |
+| grok-build | — | MCP: `~/.grok/config.toml`; Windows `%USERPROFILE%/.grok/config.toml` / `.grok/config.toml`; skills: `~/.grok/skills` / `.grok/skills` (`<skill>/SKILL.md`) |
+| mistral-vibe | — | MCP: `~/.vibe/config.toml`; Windows `%USERPROFILE%/.vibe/config.toml` / `.vibe/config.toml`; skills: `~/.vibe/skills` / `.vibe/skills` (`<skill>/SKILL.md`) |
+| lm-studio | — | MCP: `~/.lmstudio/mcp.json`; Windows `%USERPROFILE%/.lmstudio/mcp.json`; no skills folder (MCP only) |
 
 Source of truth for the setup paths: `src/installer/agent-config.ts` and
 `src/cli/commands/skills.ts`.
+
+Not supported on purpose (checked 2026-09-11): OpenHands CLI (its `[mcp] stdio_servers`
+inline-table array has a known upstream write bug), Xcode's agent folders (Apple
+documents the folder but not the file names), Pi (no MCP by design), Aider,
+ChatGPT desktop, Replit, Perplexity, JetBrains AI Assistant and Android Studio
+(UI-only MCP), Continue.dev (shut down), Void (archived), Cody (enterprise only).
+Grok Build also reads `~/.claude.json` and `.cursor/mcp.json`, so a Claude Code or
+Cursor setup already covers it; `summer setup grok-build` writes its own file too.

package/integrations/amp/README.md

@@ -0,0 +1,12 @@
+# Amp integration
+
+No manifest file is generated in this repo for Amp — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup amp` (aliases: `sourcegraph-amp`, `ampcode`), which writes:
+
+- MCP config: `~/.config/amp/settings.json`; Windows `%APPDATA%/amp/settings.json` (user); user scope only (project requests fall back with a warning).
+  Shape: `"amp.mcpServers".summer-engine = { command, args }`.
+- Skills: `~/.config/amp/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart Amp so it reloads settings.json.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/amp/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/antigravity/README.md

@@ -0,0 +1,12 @@
+# Antigravity integration
+
+No manifest file is generated in this repo for Antigravity — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup antigravity` (aliases: `agy`, `google-antigravity`), which writes:
+
+- MCP config: `~/.gemini/config/mcp_config.json`; Windows `%USERPROFILE%/.gemini/config/mcp_config.json` (user); `.agents/mcp_config.json` (project).
+  Shape: `mcpServers.summer-engine = { command, args }`.
+- Skills: `~/.gemini/config/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`.
+- After: In Antigravity open the agent panel's MCP servers view and refresh; summer-engine appears in the list (IDE and CLI share this file).
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/antigravity/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/claude-desktop/README.md

@@ -0,0 +1,12 @@
+# Claude Desktop integration
+
+No manifest file is generated in this repo for Claude Desktop — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup claude-desktop` (aliases: `claude-app`, `claudedesktop`), which writes:
+
+- MCP config: `~/Library/Application Support/Claude/claude_desktop_config.json`; Linux `~/.config/Claude/claude_desktop_config.json`; Windows `%APPDATA%/Claude/claude_desktop_config.json` (user); user scope only (project requests fall back with a warning).
+  Shape: `mcpServers.summer-engine = { command, args }`.
+- Skills: none. Claude Desktop has no skills folder. The MCP server ships summer_get_agent_playbook, so the model can pull Summer guidance in-chat.
+- After: Quit and reopen Claude Desktop; the summer-engine tools appear under the tools menu in a new chat.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/claude-desktop/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/cline/README.md

@@ -1,13 +1,12 @@
-# Cline integration
+# Cline (VS Code) integration
 
-No manifest file is generated in this repo for Cline — `manifest-target.json`
+No manifest file is generated in this repo for Cline (VS Code) — `manifest-target.json`
 is intentionally empty. Support is delivered at install time by
-`summer setup cline`, which writes:
+`summer setup cline` (aliases: `cline-vscode`), which writes:
 
-- MCP config: Cline's VS Code global storage (extension
-  `saoudrizwan.claude-dev`). User scope only — Cline has no project-scoped MCP
-  config today; project requests fall back to user scope with a warning.
-- Skills: `summer skills install --agent cline` writes rule files to Cline's
-  user rules directory (user scope) or `./.clinerules` (project scope).
+- MCP config: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; Linux `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; Windows `%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` (user); user scope only (project requests fall back with a warning).
+  Shape: `mcpServers.summer-engine = { command, args }`.
+- Skills: `~/.cline/skills` (user) or `.cline/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart VS Code so Cline reloads its MCP config.
 
-Source of truth: `src/installer/agent-config.ts`, `src/cli/commands/skills.ts`.
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/cline-cli/README.md

@@ -0,0 +1,12 @@
+# Cline CLI integration
+
+No manifest file is generated in this repo for Cline CLI — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup cline-cli` (aliases: `clinecli`), which writes:
+
+- MCP config: `~/.cline/data/settings/cline_mcp_settings.json`; Windows `%USERPROFILE%/.cline/data/settings/cline_mcp_settings.json` (user); user scope only (project requests fall back with a warning).
+  Shape: `mcpServers.summer-engine = { command, args }`.
+- Skills: `~/.cline/skills` (user) or `.cline/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart the Cline CLI so it reloads its MCP settings.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/cline-cli/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/copilot-jetbrains/README.md

@@ -0,0 +1,12 @@
+# GitHub Copilot in JetBrains IDEs integration
+
+No manifest file is generated in this repo for GitHub Copilot in JetBrains IDEs — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup copilot-jetbrains` (aliases: `jetbrains-copilot`, `intellij-copilot`, `copilot-intellij`), which writes:
+
+- MCP config: `~/.config/github-copilot/intellij/mcp.json`; Windows `%APPDATA%/github-copilot/intellij/mcp.json` (user); user scope only (project requests fall back with a warning).
+  Shape: undefined.
+- Skills: none. Copilot in JetBrains documents no skills folder; the MCP server ships summer_get_agent_playbook for in-chat guidance.
+- After: Restart the JetBrains IDE and open Copilot Chat in Agent mode; summer-engine shows in the tools list.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/copilot-jetbrains/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/crush/README.md

@@ -0,0 +1,12 @@
+# Crush integration
+
+No manifest file is generated in this repo for Crush — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup crush` (aliases: `charm-crush`), which writes:
+
+- MCP config: `~/.config/crush/crushrc`; Windows `%USERPROFILE%/.config/crush/crushrc` (user); `.crushrc` (project).
+  Shape: `mcp.summer-engine = { type: "stdio", command, args }`.
+- Skills: `~/.config/crush/skills` (user) or `.crush/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart Crush so it reloads crushrc.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/crush/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/github-copilot/README.md

@@ -1,12 +1,12 @@
 # GitHub Copilot CLI integration
 
-No manifest file is generated in this repo for Copilot CLI —
-`manifest-target.json` is intentionally empty. Support is delivered at install
-time by `summer setup github-copilot`, which writes:
+No manifest file is generated in this repo for GitHub Copilot CLI — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup github-copilot` (aliases: `copilot`, `copilot-cli`, `github-copilot-cli`), which writes:
 
-- MCP config: `~/.copilot/mcp-config.json` (user scope) or `./.mcp.json`
-  (project scope), in Copilot's MCP config format.
-- Skills: `summer skills install --agent github-copilot` writes skill files to
-  `~/.copilot/skills/` (user scope) or `./.github/skills/` (project scope).
+- MCP config: `~/.copilot/mcp-config.json`; Windows `%USERPROFILE%/.copilot/mcp-config.json` (user); `.mcp.json` (project).
+  Shape: `mcpServers.summer-engine = { type: "local", command, args, tools: ["*"] }`.
+- Skills: `~/.copilot/skills` (user) or `.github/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart Copilot CLI, or run /mcp reload and /skills reload in the active session.
 
-Source of truth: `src/installer/agent-config.ts`, `src/cli/commands/skills.ts`.
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/goose/README.md

@@ -0,0 +1,12 @@
+# Goose integration
+
+No manifest file is generated in this repo for Goose — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup goose` (aliases: `block-goose`, `codename-goose`), which writes:
+
+- MCP config: `~/.config/goose/config.yaml`; Windows `%APPDATA%/Block/goose/config/config.yaml` (user); user scope only (project requests fall back with a warning).
+  Shape: `extensions.summer-engine = { type: stdio, cmd, args, enabled, timeout }` (YAML).
+- Skills: `~/.config/agents/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart Goose (CLI or Desktop); summer-engine is listed under Extensions.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/goose/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/grok-build/README.md

@@ -0,0 +1,12 @@
+# Grok Build integration
+
+No manifest file is generated in this repo for Grok Build — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup grok-build` (aliases: `grok`, `xai-grok`), which writes:
+
+- MCP config: `~/.grok/config.toml`; Windows `%USERPROFILE%/.grok/config.toml` (user); `.grok/config.toml` (project).
+  Shape: `[mcp_servers.summer-engine]` table (TOML).
+- Skills: `~/.grok/skills` (user) or `.grok/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart Grok Build so it reloads config.toml (it also reads ~/.claude.json and .cursor/mcp.json).
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/grok-build/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/hermes/README.md

@@ -0,0 +1,12 @@
+# Hermes Agent integration
+
+No manifest file is generated in this repo for Hermes Agent — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup hermes` (aliases: `hermes-agent`, `nous-hermes`), which writes:
+
+- MCP config: `~/.hermes/config.yaml`; Windows `%USERPROFILE%/.hermes/config.yaml` (user); user scope only (project requests fall back with a warning).
+  Shape: `mcp_servers.summer-engine = { command, args }` (YAML).
+- Skills: `~/.hermes/skills` (user) or `.hermes/skills` (project) as `<skill>/SKILL.md`. Project skills need `hermes skills trust` before Hermes loads them.
+- After: Run /reload-mcp in Hermes Agent (or restart it).
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).