@askalf/claude-sync 0.0.1

package/dist/transport.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Filesystem transport — the only transport in v0.0.1.
+ *
+ * Layout under `<syncDir>`:
+ *
+ *   <syncDir>/
+ *     <encoded-project-key>/
+ *       <sessionId>-<machineName>.ccsync
+ *
+ * Project key is encoded the same way CC encodes cwds — `[/\\:.\s]+`
+ * collapsed to `-` — so `git:https://github.com/owner/repo.git` becomes
+ * `git-https---github-com-owner-repo-git`. Reversible enough for human
+ * inspection.
+ *
+ * Multiple machines can push into the same project subdir without
+ * collision: each writes a file named with its own machineName, and
+ * `pull` picks the newest non-self file per session id.
+ */
+import type { CcsyncFile } from './format.js';
+export declare function projectSubdir(syncDir: string, projectKey: string): string;
+/** Write a .ccsync file into the project's transport subdir. The
+ *  filename includes the machine name so the receiver can tell who
+ *  pushed it (and so two machines pushing the same session don't
+ *  collide). */
+export declare function pushToTransport(syncDir: string, file: CcsyncFile): string;
+export interface TransportEntry {
+    path: string;
+    file: CcsyncFile;
+    mtime: number;
+}
+/** List all .ccsync files for a project key in the transport. Sorted
+ *  by mtime descending. Files from the local machine (matching
+ *  `selfMachineName`) are omitted — pull is for receiving OTHER
+ *  machines' work, not echoing your own. */
+export declare function listTransport(syncDir: string, projectKey: string, selfMachineName: string): TransportEntry[];
+/** List all project keys present in the transport. Used by the CLI's
+ *  `pull` (no args) form to fan out across every known project. */
+export declare function listProjectKeys(syncDir: string): string[];
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;gBAGgB;AAChB,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAWzE;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;4CAG4C;AAC5C,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,cAAc,EAAE,CA0BlB;AAED;mEACmE;AACnE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWzD"}

package/dist/transport.js

@@ -0,0 +1,90 @@
+/**
+ * Filesystem transport — the only transport in v0.0.1.
+ *
+ * Layout under `<syncDir>`:
+ *
+ *   <syncDir>/
+ *     <encoded-project-key>/
+ *       <sessionId>-<machineName>.ccsync
+ *
+ * Project key is encoded the same way CC encodes cwds — `[/\\:.\s]+`
+ * collapsed to `-` — so `git:https://github.com/owner/repo.git` becomes
+ * `git-https---github-com-owner-repo-git`. Reversible enough for human
+ * inspection.
+ *
+ * Multiple machines can push into the same project subdir without
+ * collision: each writes a file named with its own machineName, and
+ * `pull` picks the newest non-self file per session id.
+ */
+import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync, readFileSync, renameSync, } from 'node:fs';
+import { join } from 'node:path';
+import { encodeProjectDir } from './project.js';
+import { parseCcsync, serializeCcsync } from './format.js';
+export function projectSubdir(syncDir, projectKey) {
+    return join(syncDir, encodeProjectDir(projectKey));
+}
+/** Write a .ccsync file into the project's transport subdir. The
+ *  filename includes the machine name so the receiver can tell who
+ *  pushed it (and so two machines pushing the same session don't
+ *  collide). */
+export function pushToTransport(syncDir, file) {
+    const dir = projectSubdir(syncDir, file.projectKey);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const filename = `${file.sessionId}-${file.machineName}.ccsync`;
+    const path = join(dir, filename);
+    // Atomic write: tmp + rename. If the sync provider mid-snapshots the
+    // dir (Dropbox does this), at least it sees a complete file.
+    const tmp = `${path}.tmp`;
+    writeFileSync(tmp, serializeCcsync(file), { mode: 0o600 });
+    renameSync(tmp, path);
+    return path;
+}
+/** List all .ccsync files for a project key in the transport. Sorted
+ *  by mtime descending. Files from the local machine (matching
+ *  `selfMachineName`) are omitted — pull is for receiving OTHER
+ *  machines' work, not echoing your own. */
+export function listTransport(syncDir, projectKey, selfMachineName) {
+    const dir = projectSubdir(syncDir, projectKey);
+    if (!existsSync(dir))
+        return [];
+    const entries = readdirSync(dir, { withFileTypes: true });
+    const result = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.ccsync'))
+            continue;
+        const path = join(dir, entry.name);
+        let file;
+        try {
+            file = parseCcsync(readFileSync(path, 'utf-8'));
+        }
+        catch {
+            // Skip malformed files quietly. The transport directory is shared
+            // across machines and might contain in-progress writes from
+            // other tools or stale tmp files.
+            continue;
+        }
+        if (file.machineName === selfMachineName)
+            continue;
+        const mtime = statSync(path).mtimeMs;
+        result.push({ path, file, mtime });
+    }
+    result.sort((a, b) => b.mtime - a.mtime);
+    return result;
+}
+/** List all project keys present in the transport. Used by the CLI's
+ *  `pull` (no args) form to fan out across every known project. */
+export function listProjectKeys(syncDir) {
+    if (!existsSync(syncDir))
+        return [];
+    const entries = readdirSync(syncDir, { withFileTypes: true });
+    return entries
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name)
+        // We could try to reverse-decode the encoded key, but the lossy
+        // encoding means we can't reliably get the original `git:...`
+        // form back. Return the encoded form; callers that need to match
+        // by raw key should encode their key first too.
+        .sort();
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@askalf/claude-sync",
+  "version": "0.0.1",
+  "description": "Sync Claude Code sessions across machines. Pack a local CC session into a portable .ccsync file, ship it via Dropbox / iCloud / Syncthing / a USB stick, unpack on the other side. Path-hash mismatches solved via git-remote-url as canonical project key.",
+  "type": "module",
+  "bin": {
+    "claude-sync": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test test/project.test.mjs test/format.test.mjs test/session.test.mjs test/cli.test.mjs",
+    "typecheck": "tsc --noEmit",
+    "audit": "npm audit --production --audit-level=high",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts"
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "session",
+    "sync",
+    "developer-tools",
+    "cli"
+  ],
+  "author": "askalf (https://github.com/askalf)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/askalf/claude-sync.git"
+  },
+  "homepage": "https://github.com/askalf/claude-sync",
+  "bugs": {
+    "url": "https://github.com/askalf/claude-sync/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsx": "^4.19.0",
+    "typescript": "^6.0.3"
+  }
+}