Local-first 🧠memory for Hermes Agent that lives in your Obsidian vault and remembers project context. Nightly 😴 dream passes turn repeat corrections into confirmed preferences with measurable confidence. Adapters ship for Claude Code, Codex, and OpenClaw, with an MCP server for anything else.
TypeScript
import { resolveLinkOutputFormat } from "../../../core/config.ts";
import { captureReportDelta, renderReportDelta } from "../../../core/brain/report-snapshot.ts";
import { isoDate } from "../../../core/brain/time.ts";
import { renderDigest, type RenderDigestOptions } from "../../../core/brain/digest.ts";
import { brainVerbContext, fail, parse, parseOptionalIsoDate } from "../helpers.ts";
export function parseWindow(raw: string): number {
const m = /^(\d+)(?:d)?$/.exec(raw);
if (!m) throw new Error(`invalid --window value: ${raw} (expected Nd or N, e.g. 7d)`);
const n = parseInt(m[1]!, 10);
if (n <= 0) throw new Error(`invalid --window value: ${raw} (must be positive)`);
return n;
}
export async function cmdBrainDigest(argv: string[]): Promise<number> {
const { flags } = parse(argv, {
vault: { type: "string" },
since: { type: "string" },
until: { type: "string" },
window: { type: "string" },
json: { type: "boolean" },
"silent-if-empty": { type: "boolean" },
});
const { config, vault } = brainVerbContext(flags);
const { value: parsedSinceDate, error: sinceErr } = parseOptionalIsoDate(flags, "since");
if (sinceErr) return fail(sinceErr);
let sinceDate = parsedSinceDate;
const { value: untilDate, error: untilErr } = parseOptionalIsoDate(flags, "until");
if (untilErr) return fail(untilErr);
if (flags["window"]) {
if (flags["since"]) {
return fail("--since and --window are mutually exclusive");
}
let windowDays: number;
try {
windowDays = parseWindow(String(flags["window"]));
} catch (e) {
process.stderr.write(`error: ${(e as Error).message}\n`);
return 2;
}
const until = untilDate ?? new Date();
sinceDate = new Date(until.getTime() - windowDays * 24 * 60 * 60 * 1000);
}
const opts: RenderDigestOptions = {
...(sinceDate ? { since: sinceDate } : {}),
...(untilDate ? { until: untilDate } : {}),
format: flags["json"] ? "json" : "markdown",
linkOutputFormat: resolveLinkOutputFormat(config),
...(config !== undefined ? { configPath: config } : {}),
};
let result;
try {
result = renderDigest(vault, opts);
} catch (exc) {
return fail(`digest failed: ${(exc as Error).message ?? exc}`);
}
if (result.empty && flags["silent-if-empty"]) return 2;
// Dual-output (t_00eece5d): snapshot the structured JSON digest and
// report the run-over-run delta when report snapshots are enabled.
let delta = null;
const digestDate = isoDate(untilDate ?? new Date());
const jsonContent = flags["json"]
? result.content
: renderDigest(vault, { ...opts, format: "json" }).content;
try {
delta = captureReportDelta(
vault,
"digest",
digestDate,
JSON.parse(jsonContent),
config ? { configPath: config } : {},
);
} catch {
// Snapshots are observability, not correctness.
}
if (flags["json"] && delta !== null) {
const parsed = JSON.parse(result.content) as Record<string, unknown>;
process.stdout.write(JSON.stringify({ ...parsed, delta }, null, 2) + "\n");
return 0;
}
process.stdout.write(result.content);
if (!result.content.endsWith("\n")) process.stdout.write("\n");
if (!flags["json"] && delta !== null) {
process.stdout.write("\n" + renderReportDelta(delta) + "\n");
}
return 0;
}