Home-dir-centric, single binary, per-project data. The runtime installs once under ~/.agent-connector (override AGENT_CONNECTOR_DATA_DIR).

~/.agent-connector/
  bin/agent-connector              single binary: CLI + hook entrypoint + telemetry
  connectors/<id>/connector.json   each registered connector's resolved definition
  telemetry.ndjson (or .db)        shared telemetry store, rows keyed by project
  backups/                         timestamped settings backups before each mutation
  logs/

• One home binary. Every host config we write is a thin pointer back to this one stable binary (a hook command is agent-connector hook <platform> <event> --connector <id>; a wrapped MCP entry runs agent-connector serve --connector <id> -- <real cmd>). Updating that single binary updates behavior in every host.
• Native config stays native. AGENT_CONNECTOR_DATA_DIR relocates only framework-owned state; a host's own settings files are never relocated.
• Per-project data. Telemetry/state is keyed by a stable project identity (gitRemote || normalizedAbsPath, hashed), surviving git clean and shared by every host opening that project.
• Explicit upgrades. agent-connector upgrade refreshes the one binary pointer — never silent auto-update, so one bad release can't break every project at once.
• Windows-first. Resolves home per-OS; no symlinks, no POSIX-only assumptions.