rohitg00/agentmemory · warning

Windows: automated `connect` is not supported yet. See https

Error message

Windows: automated `connect` is not supported yet. See https://github.com/rohitg00/agentmemory#other-agents for manual install steps.

What it means

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.

Source

Thrown at src/cli/connect/index.ts:143

      }
    }
    return result;
  } catch (err) {
    p.log.error(
      `${adapter.displayName}: ${err instanceof Error ? err.message : String(err)}`,
    );
    return { kind: "skipped", reason: "exception" };
  }
}

export async function runConnect(args: string[]): Promise<void> {
  const { dryRun, force, all, withHooks, guidelines, positional } =
    parseFlags(args);
  const allowWindowsAdapter =
    positional.length === 1 && positional[0]?.toLowerCase() === "copilot-cli";
  if (platform() === "win32" && !allowWindowsAdapter) {
    p.intro("agentmemory connect");
    p.log.warn(
      "Windows: automated `connect` is not supported yet. See https://github.com/rohitg00/agentmemory#other-agents for manual install steps.",
    );
    p.outro("Windows: manual install required — see docs");
    return;
  }

  const opts: ConnectOptions = { dryRun, force, withHooks, guidelines };

  p.intro("agentmemory connect");

  if (positional.length === 0 && !all) {
    const detected = ADAPTERS.filter((a) => a.detect());
    if (detected.length === 0) {
      p.log.error("No supported agents detected on this machine.");
      p.outro(`Supported: ${knownAgents().join(", ")}`);
      process.exit(1);
    }
    const picked = await p.multiselect<string>({

View on GitHub (pinned to e04ba88819)

Solutions

1. 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).
2. If you only need the Copilot CLI adapter, run `agentmemory connect copilot-cli` — it is the only Windows-allowed automated target.
3. Run the command from inside WSL with a Linux platform so `platform() !== 'win32'`, if your agent also runs under WSL.
4. Use the REST API or MCP server directly (npx @agentmemory/mcp) instead of the connect scaffolding.

Example fix

// before
C:\> agentmemory connect claude-code
Windows: automated `connect` is not supported yet...

// after
C:\> agentmemory connect copilot-cli
# or manually add to the agent's mcp config:
{ "mcpServers": { "agentmemory": { "command": "npx", "args": ["@agentmemory/mcp"] } } }

import { platform } from "node:platform";
if (platform() === "win32" && !args.some(a => a.toLowerCase() === "copilot-cli")) {
  console.log("Windows: use manual install steps — https://github.com/rohitg00/agentmemory#other-agents");
  return;
}
await runConnectCmd(args);

const isWindows = (): boolean => process.platform === "win32";
const isWindowsAllowedTarget = (positional: string[]): boolean =>
  positional.length === 1 && positional[0].toLowerCase() === "copilot-cli";

When it happens

Trigger: 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.

Common situations: 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.

Related errors

• ${config.displayName} hooks skipped: ${hookResult.reason}.
• OpenHuman integration is not yet automated. No `integrations
• POST ${url} failed: ${res.status} ${res.statusText}${suffix}
• agentmemory: could not locate bundled plugin/ directory (sea
• observe failed for ${obs.toolName}: ${res.status} ${res.stat

AI-assisted analysis of rohitg00/agentmemory@e04ba88819 (2026-08-30). Data as JSON: /api/errors/e3b78b8c0557cb44. Report an issue: GitHub.