Skip to content

matthewwong525/WongStack / .agents/plugins/memory

memory

Verified

FileKindSize
README.mdmarkdown4.7 KB
SKILL.mdskill md5.8 KB
VERSIONother6 B
hooks/claude.jsonconfig957 B
hooks/codex.jsonconfig692 B
references/placing-facts.mdmarkdown2.1 KB
references/recall-helper.mdmarkdown814 B
references/setup.mdmarkdown7.0 KB
references/tidy.mdmarkdown4.4 KB
references/writing-facts.mdmarkdown2.0 KB
scripts/before-edit.mjsscript2.5 KB
scripts/daily-tidy.mjsscript22.1 KB
scripts/lib/areas.mjsscript3.9 KB
scripts/lib/brief.mjsscript2.3 KB
scripts/lib/cli.mjsscript1.2 KB
scripts/lib/daily.mjsscript1.6 KB
scripts/lib/digest.mjsscript11.9 KB
scripts/lib/documents/commands.mjsscript5.7 KB
scripts/lib/documents/corpus.mjsscript6.8 KB
scripts/lib/documents/input.mjsscript2.4 KB
scripts/lib/documents/lexical.mjsscript4.5 KB
scripts/lib/documents/packet.mjsscript10.2 KB
scripts/lib/documents/retrieve.mjsscript1.9 KB
scripts/lib/files.mjsscript3.7 KB
scripts/lib/headless.mjsscript1.5 KB
scripts/lib/knowledge-copy.mjsscript469 B
scripts/lib/machine-id.mjsscript1.9 KB
scripts/lib/primary-root.mjsexecutablescript1.9 KB
scripts/lib/pull.mjsscript27.0 KB
scripts/lib/read-facts.mjsscript1.7 KB
scripts/lib/read-options.mjsscript3.0 KB
scripts/lib/scan.mjsscript2.0 KB
scripts/lib/store.mjsscript7.7 KB
scripts/lib/topics.mjsscript4.6 KB
scripts/lib/transcripts.mjsscript9.6 KB
scripts/lib/upkeep.mjsscript4.0 KB
scripts/lib/usage.mjsscript5.2 KB
scripts/memory.mjsscript45.7 KB
scripts/run.mjsscript20.4 KB
scripts/session-end.mjsscript1.7 KB
scripts/session-start.mjsscript4.6 KB
scripts/topic-match.mjsscript2.1 KB
store/contract.mjsscript14.6 KB
store/interface.d.mtsother2.9 KB
store/interface.mjsscript6.7 KB

scripts/lib/transcripts.mjs

View on GitHub
// Discover, claim, parse, and strip Claude Code and Codex transcripts. Code only: no model reads raw files.
import { appendFileSync, existsSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
import { homedir } from 'node:os';
import { basename, join, sep } from 'node:path';
import { readJson, statePath } from './store.mjs';

const IDLE_MS = 60 * 60 * 1000;
const PRUNE_AFTER_MS = 30 * 24 * 60 * 60 * 1000;
const ERROR_CHARS = 300;
const UUID = '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}';
const CLAUDE_NAME = new RegExp(`^(${UUID})\\.jsonl$`);
const CODEX_NAME = new RegExp(`^rollout-.*-(${UUID})\\.jsonl$`);

export class FormatError extends Error {}

const claudeHome = () => process.env.WONG_MEMORY_CLAUDE_HOME || join(homedir(), '.claude', 'projects');
const codexHome = () => process.env.WONG_MEMORY_CODEX_HOME || join(homedir(), '.codex', 'sessions');
export const escapeClaude = path => path.replace(/[^A-Za-z0-9]/g, '-');
export const inside = (path, dir) => path === dir || path.startsWith(dir.endsWith(sep) ? dir : dir + sep);
export const codexDayDir = (home, date) => join(home, String(date.getUTCFullYear()), String(date.getUTCMonth() + 1).padStart(2, '0'), String(date.getUTCDate()).padStart(2, '0'));
const stat = file => statSync(file, { throwIfNoEntry: false });
const parseLine = line => { try { return JSON.parse(line); } catch { return null; } };

// The session a background run was started from. It is never captured by that run.
const excluded = () => process.env.WONG_MEMORY_EXCLUDE || '';
// Subagent transcripts live in subfolders, and background runs are marked, so neither is read as a chat.
const leftOut = (chat, registry) => registry.get(chat.id)?.background || chat.id === excluded() || chat.file.split(sep).includes('subagents');

export function registerSession(ctx, entry) {
  appendFileSync(statePath(ctx, 'registry.jsonl'), `${JSON.stringify({ ...entry, ownerMachineId: ctx.machineId })}\n`);
}

export function readRegistry(ctx) {
  const file = join(ctx.stateDir, 'registry.jsonl');
  const entries = new Map();
  if (!existsSync(file)) return entries;
  for (const entry of readFileSync(file, 'utf8').split('\n').map(parseLine)) if (entry?.id && entry.ownerMachineId === ctx.machineId) entries.set(entry.id, { ...entries.get(entry.id), ...entry });
  return entries;
}

// Keep the registry small: drop entries whose transcript is gone, and captured ones older than 30 days.
export function pruneRegistry(ctx, now = Date.now()) {
  const seen = readJson(join(ctx.stateDir, 'seen.json'), {});
  const kept = [...readRegistry(ctx).values()].filter(entry => {
    const info = entry.transcript && stat(entry.transcript);
    if (!info) return false;
    return !(seen[entry.id]?.size === info.size && now - info.mtimeMs > PRUNE_AFTER_MS);
  });
  writeFileSync(statePath(ctx, 'registry.jsonl'), kept.map(entry => `${JSON.stringify({ ...entry, ownerMachineId: ctx.machineId })}\n`).join(''));
}

const cleanClaudeText = text => text
  .replace(/<system-reminder>[\s\S]*?<\/system-reminder>/g, '')
  .replace(/<(local-command-stdout|local-command-stderr|command-message)>[\s\S]*?<\/\1>/g, '')
  .replace(/<\/?(command-name|command-args)>/g, ' ')
  .trim();

const blockText = content => typeof content === 'string' ? content
  : Array.isArray(content) ? content.map(part => part?.text || '').join('\n') : '';

function claudeMessages(lines) {
  const out = [];
  for (const [line, record] of lines) {
    if (!record || record.isSidechain || record.isMeta || !['user', 'assistant'].includes(record.type)) continue;
    const content = record.message?.content;
    const parts = typeof content === 'string' ? [{ type: 'text', text: content }] : Array.isArray(content) ? content : [];
    for (const part of parts) {
      if (part?.type === 'text') {
        const text = record.type === 'user' ? cleanClaudeText(part.text || '') : (part.text || '').trim();
        if (text) out.push({ line, role: record.type, text, at: record.timestamp ?? null, ...(record.origin && { origin: record.origin.kind ?? 'other' }) });
      } else if (part?.type === 'tool_result' && part.is_error) {
        out.push({ line, role: 'error', text: blockText(part.content).slice(0, ERROR_CHARS) });
      }
    }
  }
  return out;
}

const CODEX_INJECTED = /^(<environment_context>|<user_instructions>|<permissions instructions>|# AGENTS\.md instructions)/;
const CODEX_FAILED = /(exit(?:ed with)? code:?\s*[1-9]|"exit_code":\s*[1-9])/i;

// A tool call failed when its structured exit code says so; plain-text output falls back to a pattern.
function codexFailed(output) {
  const exit = parseLine(output)?.metadata?.exit_code;
  return exit === undefined ? CODEX_FAILED.test(output) : exit !== 0;
}

function codexMessages(lines) {
  const out = [];
  for (const [line, record] of lines) {
    const item = record?.type === 'response_item' ? record.payload : null;
    if (!item) continue;
    if (item.type === 'message' && ['user', 'assistant'].includes(item.role)) {
      const text = blockText(item.content).trim();
      if (text && !(item.role === 'user' && CODEX_INJECTED.test(text))) out.push({ line, role: item.role, text, at: record.timestamp ?? null });
    } else if ((item.type || '').endsWith('_call_output') && typeof item.output === 'string' && codexFailed(item.output)) {
      out.push({ line, role: 'error', text: item.output.slice(0, ERROR_CHARS) });
    }
  }
  return out;
}

function metaOf(records) {
  if (records[0]?.type === 'session_meta') {
    const meta = records[0].payload || {};
    return { agent: 'codex', id: `codex:${meta.id}`, cwd: meta.cwd || null, branch: meta.git?.branch || null, startedAt: meta.timestamp || records[0].timestamp || null };
  }
  const first = records.find(record => record.cwd) || records.find(record => record.sessionId);
  if (!first?.sessionId) return null;
  return { agent: 'claude', id: `claude:${first.sessionId}`, cwd: first.cwd || null, branch: first.gitBranch || null, startedAt: first.timestamp || null };
}

// Parse transcript text once: format, metadata, the readable messages, and the last record's line.
export function parseTranscriptText(text) {
  const lines = text.split('\n').map((line, index) => [index + 1, parseLine(line)]);
  const records = lines.map(([, record]) => record).filter(Boolean);
  const meta = metaOf(records);
  if (!meta) throw new FormatError('not recognized');
  const messages = meta.agent === 'codex' ? codexMessages(lines) : claudeMessages(lines);
  let lastLine = 0;
  for (let i = lines.length - 1; i >= 0 && !lastLine; i -= 1) if (lines[i][1]) lastLine = lines[i][0];
  return { meta, messages, lastLine };
}

export const strip = (messages, readThrough = 0) => messages
  .filter(message => message.line > readThrough).map(message => `[${message.role}] ${message.text}`).join('\n\n');

const folders = dir => stat(dir)?.isDirectory() ? readdirSync(dir).map(name => join(dir, name)) : [];

// Recent-chat reading is explicit; capture discovery below uses registered owners only.
// With no day cutoff, every year/month/day folder is read.
function codexRollouts(days, now) {
  const home = codexHome();
  const dayDirs = Number.isFinite(days)
    ? Array.from({ length: days + 1 }, (_, offset) => codexDayDir(home, new Date(now - offset * 86400000)))
    : folders(home).flatMap(year => folders(year).flatMap(folders));
  return dayDirs.flatMap(dir => folders(dir).flatMap(file => {
    const match = basename(file).match(CODEX_NAME);
    return match ? [{ agent: 'codex', id: `codex:${match[1]}`, file }] : [];
  }));
}

// Every top-level chat on this computer changed in the last `days` days, from any folder, newest first;
// `days: Infinity` takes every chat. Subagents, the excluded session, and background runs in `registry` are left out.
export function recentTranscripts({ days = 30, now = Date.now(), registry = new Map() } = {}) {
  const home = claudeHome();
  const claude = (existsSync(home) ? readdirSync(home) : []).flatMap(folder => {
    const dir = join(home, folder);
    if (!stat(dir)?.isDirectory()) return [];
    return readdirSync(dir).flatMap(name => {
      const match = name.match(CLAUDE_NAME);
      return match ? [{ agent: 'claude', id: `claude:${match[1]}`, file: join(dir, name) }] : [];
    });
  });
  const since = now - days * 86400000;
  return [...claude, ...codexRollouts(days, now)]
    .filter(chat => !leftOut(chat, registry))
    .map(chat => ({ ...chat, mtimeMs: stat(chat.file)?.mtimeMs ?? 0 }))
    .filter(chat => chat.mtimeMs >= since)
    .sort((a, b) => b.mtimeMs - a.mtimeMs);
}

// Capture selects only registered sessions stamped with this machine owner.
function discover(ctx) {
  const registry = readRegistry(ctx);
  return [...registry.values()].filter(entry => entry.transcript).flatMap(({ agent, id, transcript: file, endedAt }) => {
    const info = !leftOut({ id, file }, registry) && stat(file);
    return info ? [{ agent, id, file, size: info.size, mtimeMs: info.mtimeMs, ended: Boolean(endedAt) }] : [];
  });
}

// Ended or idle sessions whose file changed since the last capture, newest first. Reads file metadata only.
export function pending(ctx, { now = Date.now(), exclude = [], idleMs = IDLE_MS } = {}) {
  const seen = readJson(join(ctx.stateDir, 'seen.json'), {});
  return discover(ctx)
    .filter(session => !exclude.includes(session.id))
    .filter(session => (session.ended || now - session.mtimeMs >= idleMs) && seen[session.id]?.size !== session.size)
    .sort((a, b) => b.mtimeMs - a.mtimeMs);
}

// A transcript is available for capture only through its owned registry entry.
export function sessionFile(ctx, id) {
  const registered = id !== excluded() && readRegistry(ctx).get(id)?.transcript;
  return registered && stat(registered) ? registered : null;
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall