diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2986d82a..79abe2a7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,13 @@
+## [Unreleased]
+
+### Breaking Changes
+
+* **daemon.sock path has moved:** `~/.clagentic/daemon.sock` → `~/.clagentic/console/daemon.sock`
+
+ Console creates `~/.clagentic/console/` automatically on first startup after upgrade. A one-time warning is printed if the old socket path is still present on disk.
+
+ If you use `clagentic-relay claim register` without `--daemon-sock-path`, update `CLAGENTIC_CONSOLE_HOME` from `~/.clagentic` to `~/.clagentic/console`, or pass `--daemon-sock-path ~/.clagentic/console/daemon.sock` explicitly until the relay follow-up update ships (lr-a752).
+
## [1.4.1](https://github.com/clagentic/clagentic-console/compare/v1.4.0...v1.4.1) (2026-06-08)
diff --git a/docs/guides/architecture.md b/docs/guides/architecture.md
index 69e4426d..2c2894ae 100644
--- a/docs/guides/architecture.md
+++ b/docs/guides/architecture.md
@@ -49,7 +49,7 @@ Clagentic:Console decouples the CLI from the long-running server. The CLI starts
graph TB
CLI1["npx @clagentic/console
(Terminal 1)"]
CLI2["npx @clagentic/console --add ."]
- IPC["Unix socket
~/.clagentic/daemon.sock"]
+ IPC["Unix socket
~/.clagentic/console/daemon.sock"]
Daemon["Daemon Process
lib/daemon.js"]
HTTP["HTTP / WS
:2633"]
P1["Project A"]
diff --git a/lib/config.js b/lib/config.js
index 53a7c46f..7818383d 100644
--- a/lib/config.js
+++ b/lib/config.js
@@ -73,7 +73,7 @@ function socketPath() {
var pipeName = _devMode ? "clagentic-daemon-dev" : "clagentic-daemon";
return "\\\\.\\pipe\\" + pipeName;
}
- return path.join(CONFIG_DIR, _devMode ? "daemon-dev.sock" : "daemon.sock");
+ return path.join(CONFIG_DIR, "console", _devMode ? "daemon-dev.sock" : "daemon.sock");
}
function logPath() {
@@ -88,6 +88,13 @@ function chmodSafe(filePath, mode) {
function ensureConfigDir() {
fs.mkdirSync(CONFIG_DIR, { recursive: true });
chmodSafe(CONFIG_DIR, 0o700);
+ fs.mkdirSync(path.join(CONFIG_DIR, "console"), { recursive: true });
+ chmodSafe(path.join(CONFIG_DIR, "console"), 0o700);
+ // One-time migration warning: old socket path was directly under CONFIG_DIR
+ var oldSock = path.join(CONFIG_DIR, _devMode ? "daemon-dev.sock" : "daemon.sock");
+ if (fs.existsSync(oldSock)) {
+ console.warn("[config] daemon.sock has moved to ~/.clagentic/console/daemon.sock — update any scripts or CLAGENTIC_CONSOLE_HOME settings using the old path");
+ }
}
function loadConfig() {