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 search plan` — the graph-index query pre-pass: which notes a read
* would touch, how many hops away they are, and why they were shortlisted,
* without reading them.
*/
import { planRead } from "../../../core/search/index.ts";
import {
CliError,
flagBoolean,
isIntegerWithin,
parseFlags,
resolveConfig,
VAULT_FLAGS,
} from "../helpers.ts";
const DEFAULT_MAX_HOPS = "2";
const DEFAULT_SHORTLIST_LIMIT = "10";
export async function cmdSearchPlan(argv: ReadonlyArray<string>): Promise<number> {
const { flags, positional } = parseFlags(argv, {
...VAULT_FLAGS,
hops: { type: "string", default: DEFAULT_MAX_HOPS },
limit: { type: "string", default: DEFAULT_SHORTLIST_LIMIT },
"index-only": { type: "boolean" },
json: { type: "boolean" },
});
const query = positional.join(" ").trim();
if (query === "")
throw new CliError('usage: o2b search plan "<query>" [--index-only] [--hops N]');
const cfg = resolveConfig(flags);
const maxHops = Number(flags["hops"] ?? DEFAULT_MAX_HOPS);
const shortlistLimit = Number(flags["limit"] ?? DEFAULT_SHORTLIST_LIMIT);
if (!isIntegerWithin(maxHops, { min: 0 })) {
throw new CliError(`--hops must be a non-negative integer, got '${flags["hops"]}'`);
}
if (!isIntegerWithin(shortlistLimit, { min: 1 })) {
throw new CliError(`--limit must be a positive integer, got '${flags["limit"]}'`);
}
const plan = await planRead(cfg, query, {
indexOnly: flagBoolean(flags, "index-only"),
maxHops,
shortlistLimit,
});
if (flagBoolean(flags, "json")) {
process.stdout.write(JSON.stringify(plan) + "\n");
return 0;
}
process.stdout.write(`${plan.mode} (notes read: ${plan.notesRead})\n`);
if (plan.shortlist.length === 0) {
process.stdout.write(" no candidates\n");
return 0;
}
for (const e of plan.shortlist) {
const title = e.title ?? "(untitled)";
process.stdout.write(
` ${e.path} "${title}" hops=${e.hops} degree=${e.degree} [${e.reasons.join(",")}]\n`,
);
}
return 0;
}