{"record":{"id":"e3b78b8c0557cb44","repo":"rohitg00/agentmemory","slug":"windows-automated-connect-is-not-supported-yet","errorCode":null,"errorMessage":"Windows: automated `connect` is not supported yet. See https://github.com/rohitg00/agentmemory#other-agents for manual install steps.","messagePattern":"Windows: automated `connect` is not supported yet\\. See https://github\\.com/rohitg00/agentmemory#other-agents for manual install steps\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"src/cli/connect/index.ts","lineNumber":143,"sourceCode":"      }\n    }\n    return result;\n  } catch (err) {\n    p.log.error(\n      `${adapter.displayName}: ${err instanceof Error ? err.message : String(err)}`,\n    );\n    return { kind: \"skipped\", reason: \"exception\" };\n  }\n}\n\nexport async function runConnect(args: string[]): Promise<void> {\n  const { dryRun, force, all, withHooks, guidelines, positional } =\n    parseFlags(args);\n  const allowWindowsAdapter =\n    positional.length === 1 && positional[0]?.toLowerCase() === \"copilot-cli\";\n  if (platform() === \"win32\" && !allowWindowsAdapter) {\n    p.intro(\"agentmemory connect\");\n    p.log.warn(\n      \"Windows: automated `connect` is not supported yet. See https://github.com/rohitg00/agentmemory#other-agents for manual install steps.\",\n    );\n    p.outro(\"Windows: manual install required — see docs\");\n    return;\n  }\n\n  const opts: ConnectOptions = { dryRun, force, withHooks, guidelines };\n\n  p.intro(\"agentmemory connect\");\n\n  if (positional.length === 0 && !all) {\n    const detected = ADAPTERS.filter((a) => a.detect());\n    if (detected.length === 0) {\n      p.log.error(\"No supported agents detected on this machine.\");\n      p.outro(`Supported: ${knownAgents().join(\", \")}`);\n      process.exit(1);\n    }\n    const picked = await p.multiselect<string>({","sourceCodeStart":125,"sourceCodeEnd":161,"githubUrl":"https://github.com/rohitg00/agentmemory/blob/e04ba88819c365c9acf9d6661ea802143e728bd6/src/cli/connect/index.ts#L125-L161","documentation":"The `agentmemory connect` CLI refuses to run its automated wiring on Windows. Windows config-file layouts, hook paths, and shell wrappers differ enough that the automated installer is not validated there, so the CLI short-circuits with a warning pointing to the manual install docs. The only exception is explicitly connecting the 'copilot-cli' adapter, which is the single adapter whitelisted for Windows.","triggerScenarios":"Running `agentmemory connect` (via runConnectCmd -> runConnect) on a machine where `platform() === 'win32'`, unless the command line is exactly `agentmemory connect copilot-cli` (one positional arg, case-insensitive). Any other target agent (claude-code, codex, cursor, zed, etc.) on Windows triggers this.","commonSituations":"Developers on Windows machines (or WSL misreporting, CI Windows runners) running the connect command to auto-wire their agent; running `connect` with no arguments or with multiple agent names; users upgrading from a version where Windows behavior differed.","solutions":["Run the documented manual install steps from https://github.com/rohitg00/agentmemory#other-agents (edit the agent's MCP config JSON by hand to add the agentmemory entry).","If you only need the Copilot CLI adapter, run `agentmemory connect copilot-cli` — it is the only Windows-allowed automated target.","Run the command from inside WSL with a Linux platform so `platform() !== 'win32'`, if your agent also runs under WSL.","Use the REST API or MCP server directly (npx @agentmemory/mcp) instead of the connect scaffolding."],"exampleFix":"// before\nC:\\> agentmemory connect claude-code\nWindows: automated `connect` is not supported yet...\n\n// after\nC:\\> agentmemory connect copilot-cli\n# or manually add to the agent's mcp config:\n{ \"mcpServers\": { \"agentmemory\": { \"command\": \"npx\", \"args\": [\"@agentmemory/mcp\"] } } }","handlingStrategy":"validation","validationCode":"import { platform } from \"node:platform\";\nif (platform() === \"win32\" && !args.some(a => a.toLowerCase() === \"copilot-cli\")) {\n  console.log(\"Windows: use manual install steps — https://github.com/rohitg00/agentmemory#other-agents\");\n  return;\n}\nawait runConnectCmd(args);","typeGuard":"const isWindows = (): boolean => process.platform === \"win32\";\nconst isWindowsAllowedTarget = (positional: string[]): boolean =>\n  positional.length === 1 && positional[0].toLowerCase() === \"copilot-cli\";","tryCatchPattern":null,"preventionTips":["Check `process.platform === 'win32'` before invoking `agentmemory connect` in scripts.","On Windows, only automate the copilot-cli target; use manual steps for other agents.","Prefer running the CLI inside WSL when the target agent also runs there.","Consult the '#other-agents' section of the README for the current Windows support matrix."],"tags":["windows","cli","platform-limitation","connect"],"backgroundTag":"windows-connect-unsupported","analyzedSha":"e04ba88819c365c9acf9d6661ea802143e728bd6","analyzedAt":"2026-08-30T01:07:40.754Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}