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 {
evaluateAttentionFlow,
listAttentionFlows,
renderAttentionFlow,
} from "../../../core/brain/attention-flows.ts";
import { CliError, brainVerbContext, parse } from "../helpers.ts";
export async function cmdBrainAttentionFlows(argv: string[]): Promise<number> {
const sub = argv[0];
const rest = argv.slice(1);
if (sub === "list") return list(rest);
if (sub === "evaluate") return evaluate(rest);
if (sub === "render") return render(rest);
throw new CliError("brain attention-flows: expected list, evaluate, or render");
}
function list(argv: string[]): number {
const { flags } = parse(argv, {
vault: { type: "string" },
json: { type: "boolean" },
});
const vault = brainVerbContext(flags).vault;
const flows = listAttentionFlows(vault);
if (flags["json"]) {
process.stdout.write(JSON.stringify({ total: flows.length, flows }, null, 2) + "\n");
return 0;
}
process.stdout.write(`${flows.length} attention flow(s):\n`);
for (const flow of flows) {
process.stdout.write(` ${flow.id} actions=${flow.actions.join(",") || "-"}\n`);
}
return 0;
}
function evaluate(argv: string[]): number {
const { flags, positional } = parse(argv, {
vault: { type: "string" },
json: { type: "boolean" },
});
const flowId = positional[0];
if (!flowId) throw new CliError("brain attention-flows evaluate: flow id is required");
const vault = brainVerbContext(flags).vault;
let report;
try {
report = evaluateAttentionFlow(vault, flowId);
} catch (error) {
throw mapAttentionFlowError(error, flowId);
}
if (flags["json"]) {
process.stdout.write(JSON.stringify(report, null, 2) + "\n");
return 0;
}
process.stdout.write(`${report.flow_id}: ${report.title}\n`);
for (const section of report.sections) {
process.stdout.write(` ${section.action}: ${section.items.length}\n`);
}
return 0;
}
function render(argv: string[]): number {
const { flags, positional } = parse(argv, {
vault: { type: "string" },
json: { type: "boolean" },
});
const flowId = positional[0];
if (!flowId) throw new CliError("brain attention-flows render: flow id is required");
const vault = brainVerbContext(flags).vault;
let text: string;
try {
text = renderAttentionFlow(vault, flowId);
} catch (error) {
throw mapAttentionFlowError(error, flowId);
}
if (flags["json"]) {
process.stdout.write(JSON.stringify({ flow_id: flowId, text }, null, 2) + "\n");
return 0;
}
process.stdout.write(text.endsWith("\n") ? text : text + "\n");
return 0;
}
function mapAttentionFlowError(error: unknown, flowId: string): CliError {
if (error instanceof Error) {
if (error.message.startsWith("attention flow not found:")) {
return new CliError(`brain attention-flows: unknown flow id: ${flowId}`);
}
return new CliError(error.message);
}
return new CliError("brain attention-flows: failed to evaluate flow");
}