easymd-cli 0.1.1 → 0.1.3

package/bin/easymd.js

@@ -8,6 +8,7 @@ import { syncDir, watchDir } from '../src/cli/sync.js';
 import { autoOn, autoOff, autoStatus } from '../src/cli/auto.js';
 import { getCredentials } from '../src/cli/config.js';
 import { mcpInstall } from '../src/cli/mcp-install.js';
+import { hookInstall, hookUninstall } from '../src/cli/hook-install.js';
 
 const HELP = `
 easymd — collaborate on markdown files in your repo, live with humans and AI agents
@@ -26,6 +27,8 @@ Usage:
 
   easymd mcp                   Run the MCP server (stdio) so AI agents can edit your docs
   easymd mcp-install [agent]   Register the MCP server with Cursor / Claude (agent: --cursor | --claude-desktop)
+  easymd hook-install          Auto-sync .md to your account after every Claude Code session (everywhere)
+  easymd hook-uninstall        Remove the auto-sync hook
 
   easymd open <file>           Open a local .md for real-time collaborative editing in the browser
   easymd open <file> --port N  Use a fixed port (default: random)
@@ -164,6 +167,10 @@ async function main() {
       return;
     case 'mcp-install':
       return mcpInstall(rest[0]);
+    case 'hook-install':
+      return hookInstall();
+    case 'hook-uninstall':
+      return hookUninstall();
     case 'open':
       return cmdOpen(rest);
     default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easymd-cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Google Docs for markdown — collaborate on the actual .md file in your repo, live with humans and AI agents. CLI: login, auto-sync, and open .md files for real-time editing.",
   "type": "module",
   "bin": {

package/src/cli/hook-install.js

@@ -0,0 +1,64 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+import { mkdir, readFile, writeFile, copyFile } from 'fs/promises';
+
+const CLAUDE_DIR = join(homedir(), '.claude');
+const SETTINGS = join(CLAUDE_DIR, 'settings.json');
+const HOOK_PATH = fileURLToPath(new URL('./hooks/easymd-stop-sync.sh', import.meta.url));
+const HOOK_CMD = `bash ${HOOK_PATH}`;
+const MARKER = 'easymd-stop-sync';
+
+async function readSettings() {
+  try {
+    return JSON.parse(await readFile(SETTINGS, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+async function writeSettings(s) {
+  await mkdir(CLAUDE_DIR, { recursive: true });
+  // Back up first — never clobber an existing config silently.
+  try {
+    await copyFile(SETTINGS, `${SETTINGS}.easymd-bak`);
+  } catch {
+    /* no existing file */
+  }
+  await writeFile(SETTINGS, JSON.stringify(s, null, 2));
+}
+
+// Registers a Claude Code Stop hook so that after any session that edits .md files,
+// they auto-sync to your easymd account — across every project, everywhere. Merges
+// alongside any existing Stop hooks (e.g. the obsidian-wiki capture hook).
+export async function hookInstall() {
+  const s = await readSettings();
+  s.hooks = s.hooks || {};
+  s.hooks.Stop = Array.isArray(s.hooks.Stop) ? s.hooks.Stop : [];
+
+  if (JSON.stringify(s.hooks.Stop).includes(MARKER)) {
+    console.log('✓ easymd auto-sync hook is already installed.');
+    return;
+  }
+  s.hooks.Stop.push({ matcher: '', hooks: [{ type: 'command', command: HOOK_CMD }] });
+  await writeSettings(s);
+  console.log('✓ Installed the easymd auto-sync hook in ~/.claude/settings.json');
+  console.log('  After any Claude Code session that edits .md files, they sync to your account.');
+  console.log('  Requires `easymd login`. A backup was saved to settings.json.easymd-bak.');
+  console.log('  Remove anytime with `easymd hook-uninstall`.');
+}
+
+export async function hookUninstall() {
+  const s = await readSettings();
+  if (!s.hooks?.Stop?.length) {
+    console.log('easymd auto-sync hook is not installed.');
+    return;
+  }
+  const before = s.hooks.Stop.length;
+  s.hooks.Stop = s.hooks.Stop.filter((e) => !JSON.stringify(e).includes(MARKER));
+  if (s.hooks.Stop.length === before) {
+    console.log('easymd auto-sync hook is not installed.');
+    return;
+  }
+  await writeSettings(s);
+  console.log('✓ Removed the easymd auto-sync hook.');
+}

package/src/cli/hooks/easymd-stop-sync.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# easymd auto-sync Stop hook (adapted from the obsidian-wiki Stop-capture pattern).
+#
+# Fires on the Claude Code Stop event. If the session edited any .md files and you're
+# logged into easymd, it pushes those docs to your account — so your markdown stays
+# updated in easymd after every agent session, everywhere, with no daemon running.
+#
+# Always exits 0 (silent): it runs the sync directly, it never nudges Claude.
+set -euo pipefail
+
+INPUT=$(cat)
+
+# Need credentials — no-op if not logged in.
+[[ -f "$HOME/.easymd/credentials.json" ]] || exit 0
+
+# Pull cwd + transcript path from the hook payload.
+read -r CWD TRANSCRIPT < <(printf '%s' "$INPUT" | python3 -c "
+import json, sys
+d = json.load(sys.stdin)
+print(d.get('cwd', ''), d.get('transcript_path', ''))
+" 2>/dev/null || echo " ")
+[[ -n "$TRANSCRIPT" && -f "$TRANSCRIPT" ]] || exit 0
+
+# Did this session write/edit any .md files?
+EDITED_MD=$(python3 - "$TRANSCRIPT" <<'PYEOF'
+import json, sys
+n = 0
+for line in open(sys.argv[1]):
+    line = line.strip()
+    if not line:
+        continue
+    try:
+        e = json.loads(line)
+    except json.JSONDecodeError:
+        continue
+    m = e.get("message") or {}
+    if m.get("role") != "assistant":
+        continue
+    for b in m.get("content") or []:
+        if isinstance(b, dict) and b.get("type") == "tool_use" and b.get("name") in ("Write", "Edit", "NotebookEdit"):
+            fp = (b.get("input") or {}).get("file_path", "")
+            if fp.endswith(".md"):
+                n += 1
+print(n)
+PYEOF
+)
+[[ "${EDITED_MD:-0}" -ge 1 ]] || exit 0
+
+# Resolve the easymd CLI from this script's own package (no PATH dependency).
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+EASYMD_BIN="$SCRIPT_DIR/../../../bin/easymd.js"
+[[ -f "$EASYMD_BIN" ]] || exit 0
+
+cd "${CWD:-$PWD}" 2>/dev/null || exit 0
+node "$EASYMD_BIN" sync . --quiet >/dev/null 2>&1 || true
+exit 0

package/src/cli/sync.js

@@ -5,6 +5,22 @@ import { requireCredentials } from './config.js';
 
 const IGNORE_DIRS = new Set(['node_modules', '.git', 'dist', '.next', '.turbo', 'build', 'coverage']);
 
+// "Load-bearing" agent files excluded from auto-sync by default. The account's
+// `sync_special` setting (toggled in the dashboard) opts back in.
+const SPECIAL_MD = new Set(['claude.md', 'readme.md', 'agents.md']);
+const isSpecial = (filePath) => SPECIAL_MD.has(basename(filePath).toLowerCase());
+
+// Ask the server whether this account wants the special files included.
+async function syncSpecialEnabled(creds) {
+  try {
+    const res = await fetch(`${creds.url}/api/cli/settings`, { headers: { Authorization: `Bearer ${creds.token}` } });
+    if (res.ok) return Boolean((await res.json()).syncSpecial);
+  } catch {
+    /* default to excluding on error */
+  }
+  return false;
+}
+
 // Document name sent to the server: repo-relative path without the .md extension.
 // The server slugs it (e.g. "docs/spec" → "docs-spec") and namespaces it to the account.
 function docNameFor(filePath, root) {
@@ -50,7 +66,9 @@ async function collectMarkdown(dir, root, out = []) {
 // One-shot: push every .md under `root` to the account.
 export async function syncDir(root, { quiet = false } = {}) {
   const creds = await requireCredentials();
-  const files = await collectMarkdown(root, root);
+  const includeSpecial = await syncSpecialEnabled(creds);
+  let files = await collectMarkdown(root, root);
+  if (!includeSpecial) files = files.filter((f) => !isSpecial(f));
   if (!files.length) {
     if (!quiet) console.log('No .md files found.');
     return { ok: 0, fail: 0 };
@@ -74,10 +92,12 @@ export async function syncDir(root, { quiet = false } = {}) {
 // Long-running: watch `root` and push .md files as they're added/changed.
 export async function watchDir(root, { quiet = false } = {}) {
   const creds = await requireCredentials();
+  const includeSpecial = await syncSpecialEnabled(creds);
   const log = (...a) => !quiet && console.log(...a);
 
   const pending = new Map(); // path -> timer (debounce)
   const push = (filePath) => {
+    if (!includeSpecial && isSpecial(filePath)) return; // skip CLAUDE/README/AGENTS by default
     clearTimeout(pending.get(filePath));
     pending.set(
       filePath,