nex-level-code 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,133 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+Required Notice: Copyright FTay Consulting (https://github.com/ftay1026/nex-level-code)
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

package/README.md

@@ -0,0 +1,274 @@
+# Nex Level Code (NLC)
+
+**Turn your AI coding assistant into an agent that never forgets.**
+
+One command. Persistent memory. Cross-device sync. Automatic task logging. Behavioral rules that actually stick. No infrastructure to manage, no Docker to run, no open ports, no attack surface.
+
+```bash
+npx nex-level-code install
+```
+
+Works with Claude Code, Cursor, GitHub Copilot, Windsurf, and OpenAI Codex.
+
+---
+
+## The Problem
+
+AI coding assistants are powerful — but they're goldfish.
+
+Every session starts from zero. Your agent doesn't know what it built yesterday, what decisions you made last week, or what's currently broken. You end up repeating context, re-explaining architecture, and watching it make the same mistakes you already corrected.
+
+Platforms like [OpenClaw](https://github.com/nicepkg/openclaw) solve this with a full agent gateway — 43+ messaging channels, Docker sandboxing, vector databases, device control. But that means running infrastructure, managing ports, configuring databases, and accepting a massive attack surface.
+
+**NLC takes a different approach.** Instead of replacing your tools, it enhances them. Your agent gets persistent memory, session continuity, and cross-device sync — with zero infrastructure. Just files, git, and hooks.
+
+| | OpenClaw | Claude Code + NLC |
+|---|---------|-------------------|
+| **Memory** | Vector DB (LanceDB) | Flat files + git sync |
+| **Session continuity** | JSONL + /compact | session-handoff.md + compaction |
+| **Cross-device sync** | Not built-in | Git-backed, automatic |
+| **Auto task logging** | None | Haiku-powered semantic logging |
+| **IDE integration** | None | Native (VS Code, etc.) |
+| **Attack surface** | WebSocket gateway, 43 channels, device control | Zero network-facing components |
+| **Setup** | Docker + config + multiple services | `npx nex-level-code install` |
+| **Cost** | Self-hosted + API keys | Your existing subscription ($20–$200/mo) |
+
+---
+
+## What You Get
+
+### In the Box (default install)
+
+#### 1. Memory Protocol
+Your agent follows a strict memory protocol — reading context at session start, updating it incrementally as it works, and never losing progress.
+
+- **session-handoff.md** — Living document of what's working, what's broken, key decisions, and current focus. Updated during work, not just at the end.
+- **MEMORY.md** — Project overview, architecture notes, user preferences, setup state. The agent's long-term knowledge base.
+- **Staleness warnings** — If memory files haven't been updated in over an hour, the agent gets a nudge.
+
+#### 2. Automatic Development Logging
+Every time the agent completes a meaningful task, it's logged automatically. No manual notes needed.
+
+- Fires on every agent response via a Stop hook
+- Sends the exchange to Claude Haiku for semantic analysis: *"Was a real task completed here?"*
+- If yes, logs 1–2 lines to `memory/YYYY-MM-DD.md` with a timestamp
+- Next session automatically sees yesterday's and today's logs
+- Filters out noise — reading files, asking questions, and planning don't count
+
+#### 3. Behavioral Rules
+Pre-configured rules that make your agent actually useful:
+
+- **Never ask permission to read** — files, URLs, docs. Just read them.
+- **Always ask before writing** — no surprise edits to your codebase.
+- **Log every decision** — when you make a call, it's recorded with context.
+- **PREVC workflow** — Planning, Review, Execution, Validation, Confirmation. Scales from quick bug fixes (just Execute + Validate) to complex features (full cycle).
+- **Communication style** — concise, direct, no false confidence, distinguishes solutions from workarounds.
+
+#### 4. Auto-Permissions
+Pre-approves common tool permissions (Bash, Read, Edit, Write, Grep, Glob, WebFetch, WebSearch) so you're not clicking "Allow" on every action.
+
+#### 5. MCP Server
+NLC registers an MCP server that gives your agent programmatic access to:
+
+| Tool | What it does |
+|------|-------------|
+| `nlc-status` | Check NLC installation health |
+| `nlc-handoff` | Read or update session-handoff.md |
+| `nlc-memory` | Read or update MEMORY.md |
+| `nlc-log` | Read development logs by date range |
+| `nlc-doctor` | Run diagnostics and get a health report |
+
+#### 6. Multi-Tool Support
+NLC detects which AI coding tools you have installed and configures accordingly:
+
+| Tool | Hooks | Rules File | MCP |
+|------|-------|-----------|-----|
+| **Claude Code** | Full support (5 events) | CLAUDE.md | .mcp.json |
+| **Cursor** | Pending | .cursorrules | .cursor/mcp.json |
+| **GitHub Copilot** | — | .github/copilot-instructions.md | .github/mcp.json |
+| **Windsurf** | Pending | .windsurfrules | .windsurf/mcp.json |
+| **OpenAI Codex** | — | AGENTS.md | .codex/mcp.json |
+
+---
+
+### Optional Add-Ons
+
+#### Cross-Device Memory Sync
+
+```bash
+nlc sync setup
+```
+
+Share your agent's brain across machines. Work on your desktop, close the laptop, continue from your phone or a VPS — your agent picks up exactly where it left off.
+
+- Creates a private GitHub repo for your memory files
+- Installs hooks: **SessionStart** pulls latest, **Stop** pushes updates
+- Syncs MEMORY.md, session-handoff.md, CLAUDE.md, and daily dev logs
+- Content-based diffing — only syncs when files actually change
+- Works across Windows, macOS, and Linux
+
+**How it works:**
+```
+Desktop (Stop hook) → git push → GitHub → git pull → VPS (SessionStart hook)
+```
+
+Run `nlc sync setup` on each machine. That's it.
+
+#### Web UI (Self-Hosted)
+
+Access Claude Code from any browser — phone, tablet, another computer — with a clean web interface.
+
+Based on [claudecodeui](https://github.com/siteboon/claudecodeui) with **9 production patches** applied:
+
+| Patch | Problem Fixed |
+|-------|--------------|
+| Processing hang fix | UI stuck on "Processing..." for up to 5 minutes |
+| Auto-approve tools | No more "Allow/Deny" popups for every action |
+| Inline questions | Agent questions appear in chat, not hijacking the input |
+| Textarea always enabled | Type your next message while the agent works |
+| Crash handlers | Graceful shutdown, no orphaned processes |
+| Abort on disconnect | Closing browser stops the API call (saves money) |
+| JWT secret | Real secret, not the open-source default |
+| Dead code cleanup | Removed unused imports and props |
+| HTTPS + Firewall | nginx reverse proxy, Let's Encrypt SSL, locked-down ports |
+
+> Setup guide: `nlc webui setup` *(coming soon — currently documented in [claude-code-webui.md](claude-code-webui.md))*
+
+#### Messaging Relay (Telegram + Discord)
+
+Talk to your agent from Telegram or Discord. It reads your project context, uses Claude Code under the hood, and maintains per-channel conversation threads.
+
+- Telegram: DMs with your bot
+- Discord: DMs, server channels, smart routing (only responds when relevant)
+- Bot-to-bot communication (up to 3 exchanges per channel)
+- Session continuity with `/new` to reset
+
+> Setup: See [claude-telegram-relay](https://github.com/godagoo/claude-telegram-relay) — `nlc relay setup` coming soon.
+
+---
+
+## CLI Commands
+
+```bash
+nlc install              # Install NLC to detected AI tool
+nlc install --tool cursor  # Force a specific tool
+nlc install --force      # Overwrite existing installation
+
+nlc status               # Check what's installed and healthy
+nlc doctor               # Diagnose issues and auto-fix them
+nlc update               # Update NLC scripts to latest version
+nlc uninstall            # Remove NLC (preserves your memory files)
+
+nlc sync setup           # Set up cross-device memory sync
+nlc sync status          # Check sync health and recent activity
+
+nlc mcp                  # Start the MCP server (usually auto-configured)
+```
+
+---
+
+## How It Works
+
+NLC hooks into your AI tool's lifecycle events:
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  SessionStart                                           │
+│  ├─ Pull latest memory from GitHub (if sync enabled)    │
+│  └─ Inject memory protocol + recent dev logs            │
+│                                                         │
+│  UserPromptSubmit                                       │
+│  └─ Warn if session-handoff.md is stale (>1 hour)      │
+│                                                         │
+│  Stop (after each agent response)                       │
+│  ├─ Extract preferences/requirements (memory-mcp)       │
+│  ├─ Analyze if a task was completed (Haiku)             │
+│  ├─ Log to YYYY-MM-DD.md if yes                        │
+│  └─ Push memory to GitHub (if sync enabled)             │
+│                                                         │
+│  PreCompact / SessionEnd                                │
+│  └─ Push memory to GitHub (if sync enabled)             │
+└─────────────────────────────────────────────────────────┘
+```
+
+No servers. No databases. No Docker. Just files and git.
+
+---
+
+## Roadmap
+
+NLC gives you persistent memory and session continuity today. Here's what's coming:
+
+| Feature | Status | Description |
+|---------|--------|-------------|
+| Memory protocol | ✅ Shipped | session-handoff.md + MEMORY.md |
+| Auto dev logging | ✅ Shipped | Haiku-powered task detection |
+| Behavioral rules | ✅ Shipped | PREVC workflow + communication style |
+| Cross-device sync | ✅ Shipped | Git-backed, automatic |
+| MCP server | ✅ Shipped | In-session memory tools |
+| Multi-tool support | ✅ Shipped | Claude, Cursor, Copilot, Windsurf, Codex |
+| Web UI setup | 🔧 In progress | `nlc webui setup` with auto-patching |
+| Relay setup | 🔧 In progress | `nlc relay setup` for Telegram/Discord |
+| Browser automation | 📋 Planned | Playwright integration via MCP |
+| Voice input/output | 📋 Planned | Whisper STT + TTS |
+| Scheduling | 📋 Planned | Cron-based task automation |
+| Vector memory | 📋 Planned | Semantic search over project history |
+
+---
+
+## Requirements
+
+- **Node.js** 20+ (for hook scripts)
+- **An AI coding tool** — Claude Code, Cursor, GitHub Copilot, Windsurf, or OpenAI Codex
+- **GitHub CLI** (`gh`) — only needed for `nlc sync setup`
+- **Anthropic API key** — only needed for the auto dev logger (calls Haiku at ~$0.001 per log entry)
+
+---
+
+## Install
+
+```bash
+# From npm (recommended)
+npx nex-level-code install
+
+# Or install globally
+npm install -g nex-level-code
+nlc install
+
+# From GitHub (latest)
+npx github:ftay1026/nex-level-code install
+```
+
+After installing, start a new session in your AI tool. NLC activates automatically.
+
+---
+
+## Uninstall
+
+```bash
+nlc uninstall
+```
+
+Removes all hooks, scripts, and MCP config. Your memory files (session-handoff.md, MEMORY.md, dev logs) are preserved — they're your data, not ours.
+
+---
+
+## Philosophy
+
+AI coding assistants should remember what they've done, learn from your preferences, and pick up where they left off. They shouldn't need a Kubernetes cluster to do it.
+
+NLC is opinionated:
+- **Files over databases** — Markdown files you can read, edit, and version control
+- **Git over proprietary sync** — Your memory lives in your own private repo
+- **Hooks over agents** — Lightweight lifecycle events, not a separate runtime
+- **Enhancement over replacement** — Works with your existing tools, not instead of them
+
+---
+
+## License
+
+MIT
+
+---
+
+Built by [FTay Consulting](https://github.com/ftay1026) with Claude Code + NLC (naturally).

package/dist/commands/sync.d.ts

@@ -0,0 +1,10 @@
+/**
+ * NLC Sync Command — Set up cross-device memory sync.
+ *
+ * Creates a private GitHub repo, clones it locally, installs the
+ * memory-sync hook, and registers it for SessionStart + Stop events.
+ * This lets multiple machines share the same agent "brain."
+ */
+import { Command } from 'commander';
+export declare function registerSyncCommand(program: Command): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyCpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2K1D"}

package/dist/commands/sync.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * NLC Sync Command — Set up cross-device memory sync.
+ *
+ * Creates a private GitHub repo, clones it locally, installs the
+ * memory-sync hook, and registers it for SessionStart + Stop events.
+ * This lets multiple machines share the same agent "brain."
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSyncCommand = registerSyncCommand;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const chalk_1 = __importDefault(require("chalk"));
+const child_process_1 = require("child_process");
+const tools_1 = require("../registry/tools");
+function getTemplatesDir() {
+    return path.join(__dirname, '..', '..', 'templates');
+}
+function getNodePath() {
+    return process.execPath;
+}
+function findRepo() {
+    const home = os.homedir();
+    const candidates = [
+        path.join(home, 'nex-memory'),
+        path.join(home, 'nlc-memory'),
+    ];
+    if (process.platform === 'win32') {
+        for (const d of ['C', 'D', 'E']) {
+            candidates.push(path.join(`${d}:`, 'nex-memory'));
+            candidates.push(path.join(`${d}:`, 'dev', 'nex-memory'));
+        }
+    }
+    if (process.env.NLC_MEMORY_REPO && fs.pathExistsSync(process.env.NLC_MEMORY_REPO)) {
+        return process.env.NLC_MEMORY_REPO;
+    }
+    for (const p of candidates) {
+        if (fs.pathExistsSync(path.join(p, '.git')))
+            return p;
+    }
+    return null;
+}
+function registerSyncCommand(program) {
+    const sync = program
+        .command('sync')
+        .description('Set up cross-device memory sync via a shared GitHub repo');
+    // ── nlc sync setup ──────────────────────────────────────────
+    sync
+        .command('setup')
+        .description('Create a shared memory repo and install sync hooks')
+        .option('-r, --repo <name>', 'GitHub repo name', 'nex-memory')
+        .option('-p, --path <path>', 'Local clone path (defaults to ~/nex-memory)')
+        .option('--private', 'Make the repo private (default)', true)
+        .action(async (options) => {
+        try {
+            console.log(chalk_1.default.bold('\n  NLC Memory Sync — Setup\n'));
+            // 1. Check prerequisites
+            try {
+                (0, child_process_1.execSync)('gh --version', { stdio: 'pipe' });
+            }
+            catch {
+                console.log(chalk_1.default.red('  ✗ GitHub CLI (gh) is required but not found.'));
+                console.log(chalk_1.default.dim('    Install: https://cli.github.com\n'));
+                return;
+            }
+            try {
+                (0, child_process_1.execSync)('gh auth status', { stdio: 'pipe' });
+            }
+            catch {
+                console.log(chalk_1.default.red('  ✗ Not authenticated with GitHub CLI.'));
+                console.log(chalk_1.default.dim('    Run: gh auth login\n'));
+                return;
+            }
+            // 2. Check if repo already exists locally
+            const existing = findRepo();
+            const clonePath = options.path
+                ? path.resolve(options.path)
+                : existing || path.join(os.homedir(), 'nex-memory');
+            if (existing) {
+                console.log(chalk_1.default.dim(`  Found existing repo: ${existing}`));
+            }
+            else {
+                // Create the GitHub repo
+                console.log(chalk_1.default.dim(`  Creating GitHub repo: ${options.repo}...`));
+                try {
+                    (0, child_process_1.execSync)(`gh repo create ${options.repo} --private --description "Shared AI assistant memory — synced across devices" --clone`, { cwd: path.dirname(clonePath), stdio: 'pipe', timeout: 30000 });
+                    console.log(chalk_1.default.dim(`  ✓ Repo created and cloned to ${clonePath}`));
+                }
+                catch (e) {
+                    // Repo might already exist on GitHub — try cloning
+                    try {
+                        const username = (0, child_process_1.execSync)('gh api user -q .login', { stdio: 'pipe' }).toString().trim();
+                        (0, child_process_1.execSync)(`gh repo clone ${username}/${options.repo} "${clonePath}"`, { stdio: 'pipe', timeout: 30000 });
+                        console.log(chalk_1.default.dim(`  ✓ Cloned existing repo to ${clonePath}`));
+                    }
+                    catch {
+                        console.log(chalk_1.default.red(`  ✗ Failed to create or clone repo: ${e.message}`));
+                        return;
+                    }
+                }
+            }
+            // 3. Install sync hook script
+            const tools = (0, tools_1.detectInstalledTools)();
+            if (tools.length === 0) {
+                console.log(chalk_1.default.yellow('  No AI coding tools detected.\n'));
+                return;
+            }
+            const templateSrc = path.join(getTemplatesDir(), 'hooks', 'memory-sync.js');
+            const nodePath = getNodePath();
+            for (const tool of tools) {
+                if (!tool.hooks.supported || !tool.paths.scriptsDir)
+                    continue;
+                console.log(chalk_1.default.dim(`\n  Tool: ${tool.displayName}`));
+                // Copy sync script
+                const scriptDst = path.join(tool.paths.scriptsDir, 'nlc-memory-sync.js');
+                await fs.ensureDir(tool.paths.scriptsDir);
+                await fs.copyFile(templateSrc, scriptDst);
+                console.log(chalk_1.default.dim('    ✓ Installed nlc-memory-sync.js'));
+                // Register hooks in settings
+                if (await fs.pathExists(tool.paths.settingsFile)) {
+                    try {
+                        const settings = await fs.readJSON(tool.paths.settingsFile);
+                        if (!settings.hooks)
+                            settings.hooks = {};
+                        const quote = process.platform === 'win32' ? '"' : '';
+                        const syncCommand = `${quote}${nodePath}${quote} ${quote}${scriptDst}${quote}`;
+                        // Add to SessionStart (pull — before other hooks)
+                        if (!settings.hooks.SessionStart)
+                            settings.hooks.SessionStart = [{ hooks: [] }];
+                        const startHooks = settings.hooks.SessionStart[0].hooks;
+                        const hasSyncStart = startHooks.some((h) => h.command?.includes('nlc-memory-sync'));
+                        if (!hasSyncStart) {
+                            startHooks.unshift({ type: 'command', command: syncCommand, timeout: 20 });
+                            console.log(chalk_1.default.dim('    ✓ Registered SessionStart → pull'));
+                        }
+                        // Add to Stop (push — after other hooks)
+                        if (!settings.hooks.Stop)
+                            settings.hooks.Stop = [{ hooks: [] }];
+                        const stopHooks = settings.hooks.Stop[0].hooks;
+                        const hasSyncStop = stopHooks.some((h) => h.command?.includes('nlc-memory-sync'));
+                        if (!hasSyncStop) {
+                            stopHooks.push({ type: 'command', command: syncCommand, timeout: 20 });
+                            console.log(chalk_1.default.dim('    ✓ Registered Stop → push'));
+                        }
+                        await fs.writeJSON(tool.paths.settingsFile, settings, { spaces: 2 });
+                    }
+                    catch { }
+                }
+            }
+            console.log(chalk_1.default.green('\n  ✓ Memory sync configured!\n'));
+            console.log(chalk_1.default.dim('  How it works:'));
+            console.log(chalk_1.default.dim('    • Session start → pulls latest memory from GitHub'));
+            console.log(chalk_1.default.dim('    • After each response → pushes updates to GitHub'));
+            console.log(chalk_1.default.dim('    • Run this same command on other machines to sync them\n'));
+            console.log(chalk_1.default.dim(`  Repo: ${clonePath}`));
+            console.log(chalk_1.default.dim('  To add another machine: nlc sync setup\n'));
+        }
+        catch (error) {
+            console.error(`\n  Error: ${error.message}\n`);
+            process.exit(1);
+        }
+    });
+    // ── nlc sync status ─────────────────────────────────────────
+    sync
+        .command('status')
+        .description('Show memory sync status')
+        .action(async () => {
+        const repoPath = findRepo();
+        if (!repoPath) {
+            console.log(chalk_1.default.yellow('\n  Memory sync not configured. Run: nlc sync setup\n'));
+            return;
+        }
+        console.log(chalk_1.default.bold('\n  NLC Memory Sync — Status\n'));
+        console.log(chalk_1.default.dim(`  Repo: ${repoPath}`));
+        // Check git status
+        try {
+            const log = (0, child_process_1.execSync)('git log --oneline -5', { cwd: repoPath, stdio: 'pipe' }).toString().trim();
+            console.log(chalk_1.default.dim(`\n  Recent syncs:`));
+            for (const line of log.split('\n')) {
+                console.log(chalk_1.default.dim(`    ${line}`));
+            }
+        }
+        catch {
+            console.log(chalk_1.default.red('  ✗ Could not read git log'));
+        }
+        // Check files
+        const files = fs.readdirSync(repoPath).filter(f => !f.startsWith('.') && f.endsWith('.md'));
+        console.log(chalk_1.default.dim(`\n  Files synced: ${files.length}`));
+        for (const f of files) {
+            const stat = fs.statSync(path.join(repoPath, f));
+            const age = Math.floor((Date.now() - stat.mtimeMs) / (1000 * 60));
+            const ageStr = age < 60 ? `${age}m ago` : `${Math.floor(age / 60)}h ago`;
+            console.log(chalk_1.default.dim(`    ${f} (${ageStr})`));
+        }
+        console.log('');
+    });
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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