From 85474e9d70e66484433eee8174955f6026d248e6 Mon Sep 17 00:00:00 2001
From: konard <drakonard@gmail.com>
Date: Wed, 17 Jun 2026 20:29:06 +0000
Subject: [PATCH 1/4] Initial commit with task details

Adding .gitkeep for PR creation (default mode).
This file will be removed when the task is complete.

Issue: https://github.com/ProverCoderAI/docker-git/issues/422
---
 .gitkeep | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 .gitkeep

diff --git a/.gitkeep b/.gitkeep
new file mode 100644
index 00000000..6268fa12
--- /dev/null
+++ b/.gitkeep
@@ -0,0 +1 @@
+# .gitkeep file auto-generated at 2026-06-17T20:29:06.338Z for PR creation at branch issue-422-f82d9e495b11 for issue https://github.com/ProverCoderAI/docker-git/issues/422
\ No newline at end of file

From 705ea01b9fe977610b2118e7d44f70eca1b41cc0 Mon Sep 17 00:00:00 2001
From: konard <drakonard@gmail.com>
Date: Wed, 17 Jun 2026 20:35:49 +0000
Subject: [PATCH 2/4] fix(session-sync): back up Claude sessions from
 CLAUDE_CONFIG_DIR

docker-git points Claude Code at a custom CLAUDE_CONFIG_DIR, so chat
transcripts land in "$CLAUDE_CONFIG_DIR/projects" rather than
"~/.claude/projects". The backup only scanned home-relative paths, so the
.claude folder in the docker-git-sessions backup repo stayed empty.

Resolve each session root from its agent env override (CLAUDE_CONFIG_DIR for
Claude, CODEX_HOME for Codex) with a home-relative fallback, keeping the
logical .claude/projects / .codex/sessions names stable in the backup repo.

Fixes #422
---
 .changeset/session-sync-claude-config-dir.md  | 16 ++++++
 .../docker-git-session-sync/src/backup.ts     | 15 ++++-
 packages/docker-git-session-sync/src/cli.ts   |  2 +-
 packages/docker-git-session-sync/src/core.ts  | 46 ++++++++++++++-
 .../docker-git-session-sync/src/snapshots.ts  |  4 +-
 .../tests/session-files.test.ts               | 57 +++++++++++++++++++
 6 files changed, 133 insertions(+), 7 deletions(-)
 create mode 100644 .changeset/session-sync-claude-config-dir.md

diff --git a/.changeset/session-sync-claude-config-dir.md b/.changeset/session-sync-claude-config-dir.md
new file mode 100644
index 00000000..3aefe087
--- /dev/null
+++ b/.changeset/session-sync-claude-config-dir.md
@@ -0,0 +1,16 @@
+---
+"@prover-coder-ai/docker-git-session-sync": patch
+---
+
+Back up Claude Code sessions from the resolved `CLAUDE_CONFIG_DIR` (issue #422).
+
+docker-git points Claude Code at a custom `CLAUDE_CONFIG_DIR`
+(`~/.docker-git/.orch/auth/claude/<label>`), so Claude writes chat transcripts to
+`$CLAUDE_CONFIG_DIR/projects` instead of `~/.claude/projects`. The session backup
+only scanned the home-relative paths, so the `.claude` folder in the
+`docker-git-sessions` backup repo stayed empty.
+
+The backup now resolves each session root from its agent environment override
+(`CLAUDE_CONFIG_DIR` for Claude, `CODEX_HOME` for Codex) and falls back to the
+home-relative directory when the override is unset, keeping the logical
+`.claude/projects` / `.codex/sessions` names stable in the backup repo.
diff --git a/packages/docker-git-session-sync/src/backup.ts b/packages/docker-git-session-sync/src/backup.ts
index cec8e619..56bfc4b1 100644
--- a/packages/docker-git-session-sync/src/backup.ts
+++ b/packages/docker-git-session-sync/src/backup.ts
@@ -14,6 +14,8 @@ import {
   isPathWithinParent,
   isChatTranscriptPath,
   sessionDirNames,
+  sessionRootCandidatePaths,
+  sessionRootSpecs,
   sessionWalkIgnoreDirNames,
   shouldIgnoreSessionPath,
   sortSessionFiles,
@@ -229,9 +231,16 @@ const allowedSessionRootDescription = sessionDirNames.map((dirName) => `~/${dirN
 
 const getAllowedSessionRoots = (): ReadonlyArray<SessionDir> => {
   const homeDir = os.homedir()
-  return sessionDirNames
-    .map((dirName) => ({ name: dirName, path: path.join(homeDir, dirName) }))
-    .filter((entry) => fs.existsSync(entry.path))
+  const roots: Array<SessionDir> = []
+  for (const spec of sessionRootSpecs) {
+    const existing = sessionRootCandidatePaths(spec, homeDir, process.env).find((candidatePath) =>
+      fs.existsSync(candidatePath)
+    )
+    if (existing !== undefined) {
+      roots.push({ name: spec.name, path: existing })
+    }
+  }
+  return roots
 }
 
 const resolveAllowedSessionDir = (
diff --git a/packages/docker-git-session-sync/src/cli.ts b/packages/docker-git-session-sync/src/cli.ts
index 140d9a00..38cabf4d 100644
--- a/packages/docker-git-session-sync/src/cli.ts
+++ b/packages/docker-git-session-sync/src/cli.ts
@@ -12,7 +12,7 @@ const usageText = `Usage:
   docker-git-session-sync download <snapshot-ref> [options]
 
 Options:
-  --session-dir <path>    Path under ~/.codex/sessions or ~/.claude/projects
+  --session-dir <path>    Path under \${CODEX_HOME:-~/.codex}/sessions or \${CLAUDE_CONFIG_DIR:-~/.claude}/projects
   --pr-number <number>    Open PR number to post comment to
   --repo <owner/repo>     Source repository or list filter
   --limit <number>        Maximum snapshots to list (default: 20)
diff --git a/packages/docker-git-session-sync/src/core.ts b/packages/docker-git-session-sync/src/core.ts
index a07372e9..d4f53ad1 100644
--- a/packages/docker-git-session-sync/src/core.ts
+++ b/packages/docker-git-session-sync/src/core.ts
@@ -16,7 +16,51 @@ export const backupDefaultBranch = "main"
 export const chunkManifestSuffix = ".chunks.json"
 export const maxRepoFileSize = 20 * 1000 * 1000
 export const maxPushBatchBytes = 50 * 1000 * 1000
-export const sessionDirNames: ReadonlyArray<string> = [".codex/sessions", ".claude/projects"]
+// CHANGE: Resolve session roots from agent env overrides (CLAUDE_CONFIG_DIR / CODEX_HOME).
+// WHY: docker-git points Claude Code at a custom CLAUDE_CONFIG_DIR, so chat transcripts land in
+//      "$CLAUDE_CONFIG_DIR/projects" rather than "~/.claude/projects". The backup only scanned the
+//      home-relative paths, so the Claude folder in the backup repo stayed empty (issue #422).
+// QUOTE(ТЗ): "Почему сессии от claude code не созраняются ... Папка claude вообще пустая"
+// REF: issue-422
+// SOURCE: n/a
+// FORMAT THEOREM: ∀spec,home,env: candidatePaths(spec) prefers env override base then home base.
+// PURITY: CORE
+// EFFECT: none
+// INVARIANT: logical session name is stable regardless of which physical base is used.
+// COMPLEXITY: O(1)
+export interface SessionRootSpec {
+  // Logical name used inside the backup repo (e.g. ".claude/projects").
+  readonly name: string
+  // Environment variable that overrides the base directory, when set and non-empty.
+  readonly envVar: string | null
+  // Sub-directory holding chat transcripts within the base directory.
+  readonly subDir: string
+  // Base directory relative to the user home when the env override is absent.
+  readonly homeBase: string
+}
+
+export const sessionRootSpecs: ReadonlyArray<SessionRootSpec> = [
+  { name: ".codex/sessions", envVar: "CODEX_HOME", subDir: "sessions", homeBase: ".codex" },
+  { name: ".claude/projects", envVar: "CLAUDE_CONFIG_DIR", subDir: "projects", homeBase: ".claude" }
+]
+
+export const sessionDirNames: ReadonlyArray<string> = sessionRootSpecs.map((spec) => spec.name)
+
+export const sessionRootCandidatePaths = (
+  spec: SessionRootSpec,
+  homeDir: string,
+  env: Readonly<Record<string, string | undefined>>
+): ReadonlyArray<string> => {
+  const homePath = path.join(homeDir, spec.homeBase, spec.subDir)
+  const override = spec.envVar === null ? undefined : env[spec.envVar]
+  const trimmed = typeof override === "string" ? override.trim() : ""
+  if (trimmed.length === 0) {
+    return [homePath]
+  }
+  const overridePath = path.join(trimmed, spec.subDir)
+  return overridePath === homePath ? [homePath] : [overridePath, homePath]
+}
+
 export const sessionWalkIgnoreDirNames: ReadonlySet<string> = new Set([".git", "node_modules", "tmp"])
 export const githubEnvKeys: ReadonlyArray<string> = ["GITHUB_TOKEN", "GH_TOKEN"]
 
diff --git a/packages/docker-git-session-sync/src/snapshots.ts b/packages/docker-git-session-sync/src/snapshots.ts
index ae31d631..08951910 100644
--- a/packages/docker-git-session-sync/src/snapshots.ts
+++ b/packages/docker-git-session-sync/src/snapshots.ts
@@ -183,7 +183,7 @@ export const downloadSnapshot = (options: DownloadOptions, cwd: string, output:
 
   output.out(`Downloaded snapshot to: ${outputPath}`)
   output.out("\nTo restore session files, copy them to the appropriate location:")
-  output.out("  - .codex/sessions/... -> ~/.codex/sessions/")
-  output.out("  - .claude/projects/... -> ~/.claude/projects/")
+  output.out("  - .codex/sessions/... -> ${CODEX_HOME:-~/.codex}/sessions/")
+  output.out("  - .claude/projects/... -> ${CLAUDE_CONFIG_DIR:-~/.claude}/projects/")
   return 0
 }
diff --git a/packages/docker-git-session-sync/tests/session-files.test.ts b/packages/docker-git-session-sync/tests/session-files.test.ts
index e0cad180..0457174b 100644
--- a/packages/docker-git-session-sync/tests/session-files.test.ts
+++ b/packages/docker-git-session-sync/tests/session-files.test.ts
@@ -9,6 +9,8 @@ import {
   formatTokenReduction,
   isChatTranscriptPath,
   maxRepoFileSize,
+  sessionRootCandidatePaths,
+  sessionRootSpecs,
   shouldIgnoreSessionPath,
   summarizeTokenReduction
 } from "../src/core.js"
@@ -87,6 +89,61 @@ describe("session path filtering", () => {
   })
 })
 
+describe("session root resolution", () => {
+  const codexSpec = sessionRootSpecs.find((spec) => spec.name === ".codex/sessions")
+  const claudeSpec = sessionRootSpecs.find((spec) => spec.name === ".claude/projects")
+
+  it("resolves Claude session roots from CLAUDE_CONFIG_DIR (issue #422)", () => {
+    expect(claudeSpec).toBeDefined()
+    if (claudeSpec === undefined) {
+      return
+    }
+    const configDir = path.join(tmpDir, ".docker-git", ".orch", "auth", "claude", "default")
+    const candidates = sessionRootCandidatePaths(claudeSpec, "/home/dev", {
+      CLAUDE_CONFIG_DIR: configDir
+    })
+
+    // The env override wins, but the home-relative path stays as a fallback.
+    expect(candidates).toEqual([
+      path.join(configDir, "projects"),
+      path.join("/home/dev", ".claude", "projects")
+    ])
+  })
+
+  it("falls back to the home directory when the env override is empty", () => {
+    expect(codexSpec).toBeDefined()
+    if (codexSpec === undefined || claudeSpec === undefined) {
+      return
+    }
+    expect(sessionRootCandidatePaths(codexSpec, "/home/dev", {})).toEqual([
+      path.join("/home/dev", ".codex", "sessions")
+    ])
+    expect(sessionRootCandidatePaths(claudeSpec, "/home/dev", { CLAUDE_CONFIG_DIR: "   " })).toEqual([
+      path.join("/home/dev", ".claude", "projects")
+    ])
+  })
+
+  it("resolves Codex session roots from CODEX_HOME", () => {
+    if (codexSpec === undefined) {
+      return
+    }
+    const codexHome = path.join(tmpDir, "codex-home")
+    expect(sessionRootCandidatePaths(codexSpec, "/home/dev", { CODEX_HOME: codexHome })).toEqual([
+      path.join(codexHome, "sessions"),
+      path.join("/home/dev", ".codex", "sessions")
+    ])
+  })
+
+  it("collapses to a single candidate when the override matches the home path", () => {
+    if (claudeSpec === undefined) {
+      return
+    }
+    expect(
+      sessionRootCandidatePaths(claudeSpec, "/home/dev", { CLAUDE_CONFIG_DIR: "/home/dev/.claude" })
+    ).toEqual([path.join("/home/dev", ".claude", "projects")])
+  })
+})
+
 describe("snapshot refs", () => {
   it("uses stable current refs for PR and branch snapshots", () => {
     expect(buildSnapshotRef("org/repo", 230, "issue-230")).toBe("org/repo/pr-230/current")

From 31eed1a07636fa721e342897bc23ffe154d906cf Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 17 Jun 2026 20:38:24 +0000
Subject: [PATCH 3/4] chore(release): version packages

---
 packages/app/CHANGELOG.md                     | 9 +++++++++
 packages/app/package.json                     | 2 +-
 packages/docker-git-session-sync/CHANGELOG.md | 6 ++++++
 packages/docker-git-session-sync/package.json | 2 +-
 4 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/packages/app/CHANGELOG.md b/packages/app/CHANGELOG.md
index 3cab800c..cf416b8b 100644
--- a/packages/app/CHANGELOG.md
+++ b/packages/app/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @prover-coder-ai/docker-git
 
+## 1.3.9
+
+### Patch Changes
+
+- chore: automated version bump
+
+- Updated dependencies []:
+  - @prover-coder-ai/docker-git-session-sync@1.0.65
+
 ## 1.3.8
 
 ### Patch Changes
diff --git a/packages/app/package.json b/packages/app/package.json
index 9c09bf85..fb3bf1d7 100644
--- a/packages/app/package.json
+++ b/packages/app/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@prover-coder-ai/docker-git",
-  "version": "1.3.8",
+  "version": "1.3.9",
   "description": "docker-git Bun and Gridland CLI plus browser frontend",
   "main": "dist/src/docker-git/main.js",
   "bin": {
diff --git a/packages/docker-git-session-sync/CHANGELOG.md b/packages/docker-git-session-sync/CHANGELOG.md
index cf69540f..5ab232d5 100644
--- a/packages/docker-git-session-sync/CHANGELOG.md
+++ b/packages/docker-git-session-sync/CHANGELOG.md
@@ -1,5 +1,11 @@
 # @prover-coder-ai/docker-git-session-sync
 
+## 1.0.65
+
+### Patch Changes
+
+- chore: automated version bump
+
 ## 1.0.64
 
 ### Patch Changes
diff --git a/packages/docker-git-session-sync/package.json b/packages/docker-git-session-sync/package.json
index 77537899..3f4cbabb 100644
--- a/packages/docker-git-session-sync/package.json
+++ b/packages/docker-git-session-sync/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@prover-coder-ai/docker-git-session-sync",
-  "version": "1.0.64",
+  "version": "1.0.65",
   "description": "Standalone docker-git AI agent session synchronization tool",
   "main": "dist/docker-git-session-sync.js",
   "bin": {

From 2b179adaaa268616ad2c9a4c10fd543146f2714a Mon Sep 17 00:00:00 2001
From: konard <drakonard@gmail.com>
Date: Wed, 17 Jun 2026 20:44:22 +0000
Subject: [PATCH 4/4] chore: remove stray .gitkeep artifact

---
 .gitkeep | 1 -
 1 file changed, 1 deletion(-)
 delete mode 100644 .gitkeep

diff --git a/.gitkeep b/.gitkeep
deleted file mode 100644
index 6268fa12..00000000
--- a/.gitkeep
+++ /dev/null
@@ -1 +0,0 @@
-# .gitkeep file auto-generated at 2026-06-17T20:29:06.338Z for PR creation at branch issue-422-f82d9e495b11 for issue https://github.com/ProverCoderAI/docker-git/issues/422
\ No newline at end of file