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 { buildIntentReview } from "../../../core/brain/intent-review.ts";
import { nextCommandField } from "../../../core/brain/next-step.ts";
import { emitNextStep, type AdvisoryStream } from "../../advisory-rail.ts";
import { CliError, brainVerbContext, parse } from "../helpers.ts";
/**
* `o2b brain intent-review [--vault PATH] [--now ISO] [--json]`
*
* Read-only pre-dream intent review over active signal clusters.
*/
export async function cmdBrainIntentReview(argv: string[]): Promise<number> {
const { flags } = parse(argv, {
vault: { type: "string" },
now: { type: "string" },
json: { type: "boolean" },
});
const { vault } = brainVerbContext(flags);
const now = parseNow(flags["now"]);
const report = buildIntentReview(vault, now ? { now } : {});
if (flags["json"]) {
// no-dead-ends, phase 3: the exit was computed on the human path and
// discarded here. Additive - absent when a review resolved.
const payload =
report.reviews.length === 0
? { ...report, ...nextCommandField("signal-clusters-absent") }
: report;
process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
return 0;
}
process.stdout.write(`Intent review generated ${report.generated_at}\n`);
for (const review of report.reviews) {
process.stdout.write(
` ${review.topic}: ${review.decision} (${review.signal_count} signals, ${review.risk_band} risk)\n`,
);
}
if (report.reviews.length === 0) {
process.stdout.write(" no active signal clusters\n");
// no-dead-ends, task 5: clusters are built from the signals in
// `Brain/inbox/`, so an empty review means there is nothing to
// review yet - the exit is recording one. The `--json` branch above
// returned, so this stream is provably a human one; the payload
// carries the same exit as a field.
const stream: AdvisoryStream = { command: "brain", argv, jsonRequested: false };
emitNextStep("signal-clusters-absent", stream);
}
return 0;
}
function parseNow(raw: string | boolean | string[] | undefined): Date | undefined {
if (raw === undefined || raw === false) return undefined;
if (typeof raw !== "string" || raw.trim().length === 0) {
throw new CliError("brain intent-review: --now must be an ISO-8601 timestamp");
}
const date = new Date(raw);
if (!Number.isFinite(date.getTime())) {
throw new CliError(`brain intent-review: invalid --now ${JSON.stringify(raw)}`);
}
return date;
}