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
/**
* `o2b brain summary` - operator dashboard (v0.10.16). Aggregates
* doctor, dream (dry-run), verification delta, instruction-file
* ceiling, and ranked maintenance actions into one output.
*
* Defaults to markdown so an operator can paste the report into
* their notes; `--json` returns the structured envelope for tooling.
*/
import { dream } from "../../../core/brain/dream.ts";
import {
buildOperatorSummary,
renderOperatorSummaryMarkdown,
} from "../../../core/brain/trust/operator-summary.ts";
import { brainVerbContext, fail, okJson, parse } from "../helpers.ts";
export async function cmdBrainSummary(argv: string[]): Promise<number> {
const { flags } = parse(argv, {
vault: { type: "string" },
json: { type: "boolean" },
"skip-dream": { type: "boolean" },
"top-actions": { type: "string" },
});
const { vault } = brainVerbContext(flags);
let topActionsN: number | undefined;
const topRaw = flags["top-actions"] as string | undefined;
if (topRaw !== undefined) {
const n = Number(topRaw);
if (!Number.isInteger(n) || n < 0) {
return fail(`brain summary: --top-actions must be a non-negative integer; got ${topRaw}`);
}
topActionsN = n;
}
let dreamSummary;
let dreamError: string | undefined;
if (!flags["skip-dream"]) {
try {
dreamSummary = dream(vault, { dryRun: true });
} catch (err) {
// Surface the failure rather than silently producing a partial
// dashboard. stderr keeps the human-readable text channel
// separate from the structured payload; the `dream_error`
// field on the JSON output lets automation react.
dreamError = (err as Error).message ?? String(err);
process.stderr.write(`warning: dry-run dream failed: ${dreamError}\n`);
}
}
const summary = buildOperatorSummary(vault, {
...(dreamSummary ? { dreamSummary } : {}),
...(topActionsN !== undefined ? { topActionsN } : {}),
});
if (flags["json"]) {
okJson({
trust_verdict: summary.trust_verdict,
digest_summary: summary.digest_summary,
doctor_summary: {
warning_count: summary.doctor_summary.warning_count,
error_count: summary.doctor_summary.error_count,
},
dream_summary: summary.dream_summary,
verification_delta: {
summary: summary.verification_delta.summary,
entries: summary.verification_delta.entries,
},
top_actions: summary.top_actions,
instruction_file_warnings: summary.instruction_file_warnings,
...(dreamError !== undefined ? { dream_error: dreamError } : {}),
});
return 0;
}
process.stdout.write(renderOperatorSummaryMarkdown(summary));
if (dreamError !== undefined) {
process.stdout.write(`\nDream error: ${dreamError}\n`);
}
return 0;
}