Skip to content

sno-ai/sno-station-skills / skills/R-recursive-self-improvement/rem-reflect/skill

rem-reflect

Verified

Self Learning from this machine's Claude Code, Codex, Hermes, OpenClaw and Cursor sessions. Decide skill changes and lessons with accept/reject/tbd; recall lessons at session start.

FileKindSize
SKILL.mdskill md14.1 KB
references/labeler.mdmarkdown1.2 KB
references/labeler.schema.jsonconfig1.7 KB
references/local-settings.jsonconfig126 B
references/local-writer.schema.jsonconfig2.3 KB
references/proposal.schema.jsonconfig3.2 KB
references/render.jsonconfig245 B
references/signals.jsonconfig71 B
references/text.jsonconfig4.0 KB
scripts/adopt.test.tsscript13.0 KB
scripts/adopt.tsscript14.3 KB
scripts/agent-sessions.tsscript9.1 KB
scripts/allowance-fallback.test.tsscript16.0 KB
scripts/allowance-request-isolation.test.tsscript7.1 KB
scripts/backend.tsscript9.1 KB
scripts/calls.tsscript8.6 KB
scripts/catalogue-cloud.test.tsscript1.5 KB
scripts/catalogue.tsscript3.2 KB
scripts/chunk.tsscript2.1 KB
scripts/cloud-apply.test.tsscript25.2 KB
scripts/cloud-batch.test.tsscript11.2 KB
scripts/cloud-day.test.tsscript6.8 KB
scripts/cloud-verdict.test.tsscript12.1 KB
scripts/cloud-wait.test.tsscript1.3 KB
scripts/cloud.tsscript24.4 KB
scripts/config.tsscript8.1 KB
scripts/cursor.test.tsscript16.1 KB
scripts/cursor.tsscript6.7 KB
scripts/evidence.tsscript1.5 KB
scripts/first-message.test.tsscript10.3 KB
scripts/harvest.test.tsscript16.5 KB
scripts/harvest.tsscript22.6 KB
scripts/hermes-openclaw.test.tsscript25.6 KB
scripts/identity.test.tsscript3.3 KB
scripts/identity.tsscript3.5 KB
scripts/installed-roots.test.tsscript11.0 KB
scripts/journey-adopt-lesson.test.tsscript4.1 KB
scripts/journey-ops.test.tsscript8.0 KB
scripts/labeler.test.tsscript3.6 KB
scripts/labeler.tsscript9.5 KB
scripts/ledger.tsscript2.1 KB
scripts/lessons.tsscript4.7 KB
scripts/local-filter.test.tsscript3.9 KB
scripts/local-first-output.test.tsscript22.1 KB
scripts/local-settings.tsscript1.4 KB
scripts/local-writer.tsscript12.6 KB
scripts/login-in-place.test.tsscript5.8 KB
scripts/model-json.tsscript4.1 KB
scripts/no-network.test.tsscript5.0 KB
scripts/observe.tsscript1.4 KB
scripts/page-journey.test.tsscript6.7 KB
scripts/pages.test.tsscript4.1 KB
scripts/pages.tsscript4.8 KB
scripts/proposer-loop.test.tsscript1.5 KB
scripts/proposer-validate.test.tsscript9.1 KB
scripts/proposer.tsscript8.7 KB
scripts/recall-hook.test.tsscript20.9 KB
scripts/recall.test.tsscript31.4 KB
scripts/recall.tsscript18.2 KB
scripts/reflect.test.tsscript9.3 KB
scripts/reflect.tsscript14.3 KB
scripts/rem-reflectexecutablescript823 B
scripts/rem-reflect.tsscript17.8 KB
scripts/render-chunk.test.tsscript7.2 KB
scripts/render.tsscript9.7 KB
scripts/report.tsscript8.2 KB
scripts/run-status.test.tsscript19.1 KB
scripts/sampling.test.tsscript2.1 KB
scripts/sampling.tsscript915 B
scripts/selftest-guard.test.tsscript4.2 KB
scripts/selftest/bin/claudeexecutablescript94 B
scripts/selftest/bin/codexexecutablescript93 B
scripts/selftest/bin/shim-core.cjsscript4.6 KB
scripts/selftest/bin/snoexecutablescript5.7 KB
scripts/selftest/fixtures/hermes-session-export.jsonlother1.5 KB
scripts/selftest/fixtures/openclaw-events.jsonlother3.7 KB
scripts/selftest/fixtures/verdict-traces.jsonconfig16.6 KB
scripts/selftest/journey-e2e.shexecutablescript1.4 KB
scripts/selftest/journey.mjsscript9.5 KB
scripts/selftest/observe-journey.mjsscript12.5 KB
scripts/selftest/run-selftest.shexecutablescript7.0 KB
scripts/selftest/spawn-python.mjsexecutablescript765 B
scripts/session.test.tsscript5.2 KB
scripts/session.tsscript251 B
scripts/signal-local.test.tsscript7.0 KB
scripts/skill-impact.test.tsscript6.2 KB
scripts/station-settings.test.tsscript13.6 KB
scripts/store-memory.test.tsscript3.4 KB
scripts/store.tsscript7.7 KB
scripts/test-helpers.tsscript15.3 KB
scripts/text.tsscript760 B
scripts/trigger.test.tsscript3.6 KB
scripts/trigger.tsscript2.5 KB
scripts/verdicts.test.tsscript8.1 KB
scripts/verdicts.tsscript8.0 KB

scripts/cursor.ts

View on GitHub
import { accessSync, constants, existsSync, readFileSync, readdirSync } from 'node:fs';
import { homedir } from 'node:os';
import { isAbsolute, join } from 'node:path';
import { isObject, reflectionFiles } from './config.ts';
import type { ParsedLine } from './harvest.ts';
import { gitTop } from './identity.ts';
import { firstMessageRecall, recall } from './recall.ts';
import type { CommandResult } from './rem-reflect.ts';
import { atomicWrite } from './store.ts';

// IDE and CLI write the same layout: <root>/<project>/agent-transcripts/<id>/<id>.jsonl.
export function cursorTranscripts(root: string): string[] {
  if (!existsSync(root)) return [];
  return readdirSync(root).flatMap(project => {
    const dir = join(root, project, 'agent-transcripts');
    return existsSync(dir) ? readdirSync(dir).map(id => join(dir, id, `${id}.jsonl`)).filter(path => existsSync(path)) : [];
  });
}

// A Cursor row is `{role, message: {content}}`; Claude's `{type, message: {role, content}}` lets every reader stay shared.
export function cursorLines(lines: readonly ParsedLine[]): ParsedLine[] {
  return lines.map(line => {
    const { role, message } = line.record;
    return typeof role === 'string' && isObject(message) ? { ...line, record: { type: role, message: { ...message, role } } } : line;
  });
}

// What the user typed: the `<user_query>` body, without Cursor's `<timestamp>` line.
export function cursorUserText(text: string): string | undefined {
  return /<user_query>\n?([\s\S]*?)\n?<\/user_query>/.exec(text)?.[1];
}

// The repository the Cursor hooks recorded for a conversation; '' (unscoped) when there is none.
export function cursorProject(id: string, log: string[]): string {
  const path = join(process.env.SNO_PROFILE_DIR ?? join(homedir(), '.sno'), 'cursor', 'conversations', `${id}.json`);
  if (!existsSync(path)) return '';
  try {
    const record: unknown = JSON.parse(readFileSync(path, 'utf8'));
    return isObject(record) && typeof record.project === 'string' ? record.project : '';
  } catch (error) {
    log.push(`cursor conversation record ${path} unreadable: ${String(error)}; conversation collected unscoped`);
    return '';
  }
}

function shownBefore(store: string, session: string): boolean {
  const path = join(store, reflectionFiles.usage);
  if (!existsSync(path)) return false;
  return readFileSync(path, 'utf8').split('\n').some(line => {
    try { const row: unknown = JSON.parse(line); return isObject(row) && row.type === 'shown' && row.session_id === session; }
    catch { return false; }
  });
}

// The Cursor hook answer: always exit 0 with `{}` or `{"additional_context": …}`; failures go to stderr.
// The project is the git root of `workspace_roots[0]` (Cursor sends no `cwd`). The first-prompt hook also brings
// the index when no session start showed it, because the IDE's first chat in a new window has no `sessionStart`.
// `heartbeat` is called only when the index is built: it can take seconds and the prompt hook has eight.
export function cursorRecall(store: string, firstMessage: boolean, stdin: string, heartbeat: () => string): CommandResult {
  const stderr: string[] = [];
  const answer = (parts: string[]): CommandResult =>
    ({ code: 0, lines: [JSON.stringify(parts.length ? { additional_context: parts.join('\n') } : {})], stderr });
  try {
    const input: unknown = JSON.parse(stdin);
    const fields = isObject(input) ? input : {};
    const session = typeof fields.session_id === 'string' ? fields.session_id : fields.conversation_id;
    const roots = Array.isArray(fields.workspace_roots) ? fields.workspace_roots : [];
    const cwd = typeof roots[0] === 'string' ? gitTop(roots[0]) : undefined;
    if (typeof session !== 'string' || !cwd) {
      stderr.push(`recall --agent cursor: ${typeof session !== 'string' ? 'no conversation_id' : 'workspace_roots[0] is in no git work tree'}; nothing shown`);
      return answer([]);
    }
    const parts: string[] = [];
    if (!firstMessage || !shownBefore(store, session)) {
      const index = recall(store, 'cursor', { session_id: session, cwd }, new Date(), heartbeat());
      stderr.push(...(index.stderr ?? []));
      if (index.code !== 0) { stderr.push(...index.lines); return answer([]); }
      parts.push(...index.lines);
    }
    if (firstMessage) {
      const prompt = typeof fields.prompt === 'string' ? fields.prompt : undefined;
      for (const line of firstMessageRecall(store, 'cursor', { session_id: session, cwd, prompt }).lines) {
        const output: unknown = JSON.parse(line);
        if (isObject(output) && isObject(output.hookSpecificOutput) && typeof output.hookSpecificOutput.additionalContext === 'string') {
          parts.push(output.hookSpecificOutput.additionalContext);
        }
      }
    }
    return answer(parts);
  } catch (error) {
    stderr.push(`recall --agent cursor failed: ${error instanceof Error ? error.message : String(error)}; nothing shown`);
    return answer([]);
  }
}

// The entries name sno by absolute path: an IDE started from the macOS desktop may not have ~/.local/bin on PATH.
function snoPath(): string {
  for (const dir of (process.env.PATH ?? '').split(':').filter(part => isAbsolute(part))) {
    try { accessSync(join(dir, 'sno'), constants.X_OK); return join(dir, 'sno'); } catch { /* not in this folder */ }
  }
  throw new Error('recall install: sno is not on PATH, and the Cursor hook entries need its absolute path');
}
const ownEntry = (entry: unknown): boolean =>
  isObject(entry) && typeof entry.command === 'string' && entry.command.includes('rem-reflect recall --agent cursor');

// `sno rem-reflect recall install`: write the two lesson-recall entries into ~/.cursor/hooks.json, replacing an
// earlier copy in place and keeping every entry another program wrote.
export function installCursorHooks(): CommandResult {
  const path = join(homedir(), '.cursor', 'hooks.json');
  const file: unknown = existsSync(path) ? JSON.parse(readFileSync(path, 'utf8')) : { version: 1 };
  if (!isObject(file)) throw new Error(`${path}: expected a JSON object`);
  const hooks = isObject(file.hooks) ? file.hooks : {};
  const sno = snoPath();
  const recallHooks = {
    sessionStart: { command: `'${sno}' rem-reflect recall --agent cursor`, timeout: 15 },
    beforeSubmitPrompt: { command: `'${sno}' rem-reflect recall --agent cursor --first-message`, timeout: 8 },
  };
  for (const [event, entry] of Object.entries(recallHooks)) {
    const list: unknown[] = Array.isArray(hooks[event]) ? hooks[event] : [];
    const at = list.findIndex(ownEntry);
    const kept = list.filter(item => !ownEntry(item));
    kept.splice(at < 0 ? kept.length : at, 0, entry);
    hooks[event] = kept;
  }
  atomicWrite(path, `${JSON.stringify({ ...file, hooks }, null, 2)}\n`);
  return { code: 0, lines: [`wrote the sessionStart and beforeSubmitPrompt lesson-recall hooks to ${path}`] };
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall