@sickr/replay 0.1.0 → 0.2.0

package/dist/cli.js

@@ -1,19 +1,58 @@
 #!/usr/bin/env node
 import { pathToFileURL } from 'node:url';
-import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, statSync } from 'node:fs';
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, statSync, unlinkSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { spawn } from 'node:child_process';
 import { appendEvent, loadRun, runsDir, latestRunId } from './recorder.js';
-import { mergeHooks } from './hookConfig.js';
+import { mergeHooks, removeHooks } from './hookConfig.js';
 import { renderRunHtml } from './render.js';
-import { buildSharePayload, publish } from './share.js';
+import { buildSharePayload, publish, PublishError } from './share.js';
 const REPLAY_ENDPOINT = process.env.SICKR_REPLAY_ENDPOINT ?? 'https://sickr.ai/api/replay';
-const COMMANDS = ['init', 'record', 'open', 'list', 'share'];
+const COMMANDS = ['init', 'record', 'open', 'list', 'share', 'stop', 'clear', 'help'];
 export function parseCommand(argv) {
     const c = argv[0];
     return c && COMMANDS.includes(c) ? c : null;
 }
+export const HELP = `SICKR Replay — audit & replay what your AI coding agent did.
+
+Records your Claude Code session (prompts, edits, commands) to a local, redacted
+timeline you can replay — and optionally share as a public link.
+
+Why: a durable record of every agent action. If your agent (Claude or Codex)
+loses context or can't reload a past chat, the replay log helps you — and it —
+recall what was just done.
+
+Usage: npx @sickr/replay <command> [options]
+
+Commands:
+  init           Install the Claude Code recording hooks in this project and
+                 start capturing runs to ~/.sickr/runs (secrets redacted).
+  open [run]     Render a run to a local HTML timeline and open it in your
+                 browser. 100% local — nothing is uploaded.
+  share [run]    Redact and publish ONE run to a public sickr.ai/r/<id> link
+                 (shows a preview and asks first). Links expire after 24h.
+                   --open   also open the published link in your browser
+                   --yes    skip the confirmation prompt
+  list           List recorded runs, newest first.
+  stop           Stop recording — removes SICKR's hooks from this project.
+                 Your recorded runs are kept; run \`init\` to start again.
+  clear          Delete all local runs in ~/.sickr/runs (asks first).
+  help           Show this help.
+
+────────────────────────────────────────────────────────────────────
+This tool audits ONE agent on ONE machine. SICKR governs your whole team.
+
+  · Gates & approvals — plan sign-off, review, merge and validation checks
+    that work HOLDS at until they pass.
+  · Humans + agents on one board — agents are first-class teammates with
+    roles, capacity and accountability, not a side channel.
+  · A full, signed-off audit trail across every actor and every change.
+  · Runs 24/7 — produce as much work as you like; the team handles it.
+
+  Free tier available · bring your own Claude or Codex subscription.
+  → https://sickr.ai
+`;
 export function currentRunId(cc) {
     return String(cc.session_id ?? 'session');
 }
@@ -38,6 +77,52 @@ function handleInit() {
         `Runs are recorded locally to ${runsDir()} (secrets redacted).\n` +
         `Use Claude Code as normal, then: npx @sickr/replay open\n`);
 }
+/** Stop recording: remove SICKR's hooks from this project's settings, keep runs. */
+export function handleStop() {
+    const settingsPath = join(process.cwd(), '.claude', 'settings.json');
+    if (!existsSync(settingsPath)) {
+        process.stdout.write('sickr: no .claude/settings.json here — not recording in this project.\n');
+        return;
+    }
+    let settings;
+    try {
+        settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+    }
+    catch {
+        process.stderr.write(`sickr: could not parse ${settingsPath}; left it unchanged.\n`);
+        return;
+    }
+    writeFileSync(settingsPath, JSON.stringify(removeHooks(settings), null, 2) + '\n');
+    process.stdout.write('sickr: recording stopped — removed SICKR hooks from .claude/settings.json.\n' +
+        'Your recorded runs are kept. Run `npx @sickr/replay init` to start again.\n');
+}
+/** Delete all local runs. Destructive — confirms unless `yes` is set. */
+export async function handleClear(yes) {
+    const dir = runsDir();
+    const files = existsSync(dir) ? readdirSync(dir).filter((f) => f.endsWith('.ndjson')) : [];
+    if (files.length === 0) {
+        process.stdout.write('sickr: no local runs to clear.\n');
+        return;
+    }
+    if (!yes) {
+        if (!process.stdin.isTTY) {
+            process.stderr.write(`sickr: ${files.length} run(s) in ${dir}. Re-run with --yes to delete them.\n`);
+            process.exit(1);
+            return;
+        }
+        process.stdout.write(`Delete ${files.length} recorded run(s) from ${dir}? This cannot be undone. [y/N] `);
+        const answer = await new Promise((resolve) => {
+            process.stdin.once('data', (d) => resolve(d.toString().trim().toLowerCase()));
+        });
+        if (answer !== 'y' && answer !== 'yes') {
+            process.stdout.write('sickr: cancelled.\n');
+            return;
+        }
+    }
+    for (const f of files)
+        unlinkSync(join(dir, f));
+    process.stdout.write(`sickr: cleared ${files.length} run(s).\n`);
+}
 function openInBrowser(file) {
     const cmd = process.platform === 'win32' ? 'cmd' : process.platform === 'darwin' ? 'open' : 'xdg-open';
     const args = process.platform === 'win32' ? ['/c', 'start', '', file] : [file];
@@ -70,7 +155,7 @@ function handleList() {
         .sort((a, b) => statSync(join(dir, b)).mtimeMs - statSync(join(dir, a)).mtimeMs)
         .forEach((f) => process.stdout.write(`${f.replace(/\.ndjson$/, '')}\t${statSync(join(dir, f)).mtime.toISOString()}\n`));
 }
-async function handleShare(runId, yes) {
+async function handleShare(runId, yes, open) {
     const id = runId ?? latestRunId();
     if (!id) {
         process.stderr.write('sickr: no runs to share. Use Claude Code first.\n');
@@ -79,9 +164,8 @@ async function handleShare(runId, yes) {
     }
     const run = loadRun(id);
     const payload = buildSharePayload(run);
-    process.stdout.write(`sickr: about to publish run "${id}" (${payload.run.events.length} events, secrets already redacted) to ${REPLAY_ENDPOINT}\n`);
-    for (const e of payload.run.events)
-        process.stdout.write(`  · ${e.label}: ${e.detail || ''}\n`);
+    process.stdout.write(`sickr: about to publish run "${id}" (${payload.run.events.length} events, secrets already redacted) to ${REPLAY_ENDPOINT}\n` +
+        `sickr: tip — run \`npx @sickr/replay open ${id}\` to review the full timeline locally before sharing.\n`);
     if (!yes) {
         if (!process.stdin.isTTY) {
             process.stderr.write('sickr: re-run with --yes to publish non-interactively.\n');
@@ -97,8 +181,34 @@ async function handleShare(runId, yes) {
             return;
         }
     }
-    const { url } = await publish(payload, REPLAY_ENDPOINT);
+    let url;
+    try {
+        ({ url } = await publish(payload, REPLAY_ENDPOINT));
+    }
+    catch (err) {
+        if (err instanceof PublishError && err.status === 429) {
+            process.stdout.write('sickr: rate-limited — you can publish about once every 10s. Waiting to retry once...\n');
+            await new Promise((r) => setTimeout(r, 11_000));
+            try {
+                ({ url } = await publish(payload, REPLAY_ENDPOINT));
+            }
+            catch (retryErr) {
+                if (retryErr instanceof PublishError && retryErr.status === 429) {
+                    process.stderr.write('sickr: still rate-limited. Give it a minute and run `share` again.\n');
+                    process.exit(1);
+                    return;
+                }
+                throw retryErr;
+            }
+        }
+        else {
+            throw err;
+        }
+    }
     process.stdout.write(`sickr: published → ${url}\n`);
+    process.stdout.write('sickr: this link expires in 24h.\n');
+    if (open)
+        openInBrowser(url);
 }
 async function readStdin() {
     const chunks = [];
@@ -108,7 +218,12 @@ async function readStdin() {
 }
 async function main() {
     const argv = process.argv.slice(2);
+    if (argv.length === 0 || argv[0] === 'help' || argv.includes('--help') || argv.includes('-h')) {
+        process.stdout.write(HELP);
+        return;
+    }
     const cmd = parseCommand(argv);
+    const rest = argv.slice(1);
     switch (cmd) {
         case 'record':
             handleRecord(await readStdin());
@@ -122,14 +237,18 @@ async function main() {
         case 'list':
             handleList();
             return;
-        case 'share': {
-            const rest = argv.slice(1);
-            await handleShare(rest.find((a) => !a.startsWith('-')), rest.includes('--yes'));
+        case 'stop':
+            handleStop();
+            return;
+        case 'clear':
+            await handleClear(rest.includes('--yes') || rest.includes('-y'));
+            return;
+        case 'share':
+            await handleShare(rest.find((a) => !a.startsWith('-')), rest.includes('--yes') || rest.includes('-y'), rest.includes('--open'));
             return;
-        }
         default:
-            process.stderr.write('usage: npx @sickr/replay <init|record|open|list|share>\n');
-            process.exit(argv[0] ? 1 : 0);
+            process.stderr.write('sickr: unknown command. Run `npx @sickr/replay help`.\n');
+            process.exit(1);
     }
 }
 const invokedDirectly = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;

package/dist/hookConfig.js

@@ -17,3 +17,26 @@ export function mergeHooks(settings, binPath) {
     }
     return next;
 }
+/**
+ * Remove the SICKR recording hooks from a Claude Code settings object — the
+ * inverse of mergeHooks. Unrelated hooks are preserved; an event left with no
+ * hooks is dropped so settings.json stays clean.
+ */
+export function removeHooks(settings) {
+    const next = { ...(settings ?? {}) };
+    if (!next.hooks)
+        return next;
+    const hooks = { ...next.hooks };
+    for (const ev of EVENTS) {
+        const groups = Array.isArray(hooks[ev]) ? hooks[ev] : undefined;
+        if (!groups)
+            continue;
+        const kept = groups.filter((g) => !JSON.stringify(g).includes(TAG));
+        if (kept.length > 0)
+            hooks[ev] = kept;
+        else
+            delete hooks[ev];
+    }
+    next.hooks = hooks;
+    return next;
+}

package/dist/render.js

@@ -2,6 +2,35 @@ const PLASMA = '#34e0ff';
 function esc(s) {
     return s.replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
 }
+// Inline Sickr wordmark (mirrors src/components/SickrLogo.tsx) — static ids.
+function wordmark() {
+    return `<svg viewBox="0 0 1105 395" role="img" aria-label="Sickr" class="logo" shape-rendering="geometricPrecision">
+  <defs>
+    <linearGradient id="lg-silver" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#ffffff"/><stop offset="36%" stop-color="#f6f8fb"/>
+      <stop offset="58%" stop-color="#c7cedb"/><stop offset="78%" stop-color="#ffffff"/><stop offset="100%" stop-color="#dde3ee"/>
+    </linearGradient>
+    <filter id="lg-fx" x="-10%" y="-12%" width="120%" height="124%">
+      <feGaussianBlur stdDeviation="5" result="b"/>
+      <feColorMatrix in="b" type="matrix" values="0 0 0 0 0.20  0 0 0 0 0.88  0 0 0 0 1  0 0 0 0.5 0" result="g"/>
+      <feMerge><feMergeNode in="g"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <mask id="lg-s" maskUnits="userSpaceOnUse"><rect width="1105" height="395" fill="white"/><polygon points="101,258 270,145 202,204 161,213" fill="black"/></mask>
+    <mask id="lg-i" maskUnits="userSpaceOnUse"><rect width="1105" height="395" fill="white"/><polygon points="361,260 396,229 396,252 361,283" fill="black"/></mask>
+    <mask id="lg-c" maskUnits="userSpaceOnUse"><rect width="1105" height="395" fill="white"/><polygon points="458,272 493,244 504,262 469,290" fill="black"/></mask>
+    <mask id="lg-r" maskUnits="userSpaceOnUse"><rect width="1105" height="395" fill="white"/><polygon points="888,266 920,238 920,261 888,289" fill="black"/></mask>
+  </defs>
+  <g fill="url(#lg-silver)" filter="url(#lg-fx)">
+    <path mask="url(#lg-s)" d="M 70 324 L 110 296 L 221 296 C 243 296 258 282 258 260 C 258 238 247 223 224 207 L 244 188 C 272 204 286 227 286 258 C 286 297 260 324 228 324 Z M 136 213 C 109 199 96 179 96 153 C 96 109 122 77 156 77 L 296 77 L 262 106 L 158 106 C 138 106 124 125 124 153 C 124 171 134 184 157 195 Z"/>
+    <polygon points="268,146 200,203 109,256 162,211"/>
+    <circle cx="378" cy="116" r="19"/>
+    <path mask="url(#lg-i)" d="M 366 182 L 395 155 L 395 299 L 366 324 Z"/>
+    <path mask="url(#lg-c)" d="M 623 153 L 587 182 L 530 182 C 504 182 486 204 486 234 C 486 264 504 285 529 285 L 625 285 L 591 314 L 520 314 C 482 314 457 282 457 237 C 457 191 482 153 518 153 Z"/>
+    <path d="M 684 98 L 714 70 L 714 200 L 684 227 Z M 684 254 L 796 151 L 837 151 L 714 265 L 714 294 L 684 320 Z M 764 238 L 841 313 L 802 313 L 744 256 Z"/>
+    <path mask="url(#lg-r)" d="M 889 321 L 889 193 C 889 168 906 153 927 153 L 1034 153 L 998 182 L 934 182 C 924 182 918 189 918 199 L 918 295 Z"/>
+  </g>
+</svg>`;
+}
 function dot(kind) {
     return kind === 'tool' ? PLASMA : kind === 'prompt' ? '#8b95a7' : '#5f6b80';
 }
@@ -20,11 +49,15 @@ export function renderRunHtml(run) {
     return `<!doctype html>
 <html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width,initial-scale=1"/>
 <title>SICKR Replay — ${esc(run.id)}</title>
+<link rel="preconnect" href="https://fonts.googleapis.com"/>
+<link href="https://fonts.googleapis.com/css2?family=Chakra+Petch:wght@600;700&family=Sora:wght@300;400;600&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet"/>
 <style>
   body{margin:0;background:#06080d;color:#e7ecf3;font-family:Sora,system-ui,Arial,sans-serif;padding:40px 20px}
   .wrap{max-width:820px;margin:0 auto}
-  .brand{font-family:"Chakra Petch",sans-serif;color:${PLASMA};letter-spacing:.04em;font-weight:700}
-  .meta{font-family:"JetBrains Mono",ui-monospace,monospace;font-size:12px;color:#5f6b80;margin:6px 0 28px}
+  .bar{display:flex;align-items:center;justify-content:space-between;gap:16px;margin-bottom:24px}
+  .logo{height:30px;width:auto;display:block}
+  .bar a{font-family:"JetBrains Mono",monospace;font-size:11px;letter-spacing:.16em;text-transform:uppercase;color:${PLASMA};text-decoration:none}
+  .meta{font-family:"JetBrains Mono",ui-monospace,monospace;font-size:12px;color:#5f6b80;margin:0 0 28px}
   ol{list-style:none;margin:0;padding:0;position:relative}
   ol::before{content:"";position:absolute;left:6px;top:6px;bottom:6px;width:1px;background:linear-gradient(${PLASMA},transparent)}
   li{position:relative;padding:0 0 18px 28px}
@@ -33,13 +66,21 @@ export function renderRunHtml(run) {
   .kind{font-family:"JetBrains Mono",monospace;font-size:10px;text-transform:uppercase;letter-spacing:.12em;color:${PLASMA};margin-left:6px}
   .detail{font-family:"JetBrains Mono",monospace;font-size:12.5px;color:#cdd5e1;margin-top:4px;white-space:pre-wrap;word-break:break-word}
   .time{font-family:"JetBrains Mono",monospace;font-size:11px;color:#5f6b80;margin-top:3px}
-  .cta{margin-top:36px;border-top:1px solid #1b2435;padding-top:20px;font-size:14px;color:#8b95a7}
-  .cta a{color:${PLASMA};text-decoration:none}
+  .cta{margin-top:36px;border:1px solid #1b2435;border-radius:12px;background:rgba(8,12,20,.55);padding:22px}
+  .cta h2{font-family:"Chakra Petch",sans-serif;font-weight:700;font-size:18px;color:#fff;margin:0 0 8px}
+  .cta p{font-size:14px;line-height:1.6;color:#9aa6b6;margin:0 0 16px}
+  .btn{display:inline-flex;align-items:center;gap:8px;background:${PLASMA};color:#06080d;font-family:"JetBrains Mono",monospace;font-size:12px;font-weight:600;text-transform:uppercase;letter-spacing:.08em;padding:11px 16px;border-radius:6px;text-decoration:none;box-shadow:0 0 24px rgba(52,224,255,.3)}
+  .share-hint{margin-top:14px;font-family:"JetBrains Mono",monospace;font-size:11px;color:#5f6b80}
 </style></head>
 <body><div class="wrap">
-  <div class="brand">sickr</div>
-  <div class="meta">replay · ${esc(run.id)} · ${esc(run.cwd || '')} · ${run.events.length} events</div>
+  <div class="bar">${wordmark()}<a href="https://sickr.ai">sickr.ai →</a></div>
+  <div class="meta">local replay · ${esc(run.id)} · ${esc(run.cwd || '')} · ${run.events.length} events</div>
   <ol>${events}</ol>
-  <div class="cta">This is one local agent run. Govern your whole team — gates, approvals, multi-agent, full audit → <a href="https://sickr.ai">sickr.ai</a></div>
+  <div class="cta">
+    <h2>This is one agent, on your machine.</h2>
+    <p>SICKR governs your whole team — gates, approvals, multi-agent hand-offs and a full, signed-off audit trail across humans and agents. Free tier · bring your own Claude or Codex.</p>
+    <a class="btn" href="https://sickr.ai">Explore SICKR →</a>
+    <div class="share-hint">Tip: <code>npx @sickr/replay share</code> publishes this run to a public link.</div>
+  </div>
 </div></body></html>`;
 }

package/dist/share.js

@@ -2,6 +2,14 @@
 export function buildSharePayload(run) {
     return { run: { cwd: run.cwd, startedAt: run.startedAt, events: run.events } };
 }
+export class PublishError extends Error {
+    status;
+    constructor(status) {
+        super(`publish failed: ${status}`);
+        this.status = status;
+        this.name = 'PublishError';
+    }
+}
 export async function publish(payload, endpoint) {
     const res = await fetch(endpoint, {
         method: 'POST',
@@ -9,6 +17,6 @@ export async function publish(payload, endpoint) {
         body: JSON.stringify(payload),
     });
     if (!res.ok)
-        throw new Error(`publish failed: ${res.status}`);
+        throw new PublishError(res.status);
     return (await res.json());
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sickr/replay",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "npx @sickr/replay — local Claude Code audit + one-click share. The free wedge into SICKR.",
   "bin": { "replay": "dist/cli.js" },