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 state` CLI surface (t_b0c9d0a3): the overwrite-only
* exact-state lane - set overwrites, get/list read, clear removes.
*/
import { afterEach, beforeEach, expect, setDefaultTimeout, test } from "bun:test";
import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { runCli } from "../helpers/run-cli.ts";
import { CLI_SPAWN_BUDGET_MS } from "../helpers/cli-timeout.ts";
// Tests here spawn processes; see tests/helpers/cli-timeout.ts.
setDefaultTimeout(CLI_SPAWN_BUDGET_MS);
let tmp: string;
let vault: string;
beforeEach(() => {
tmp = mkdtempSync(join(tmpdir(), "o2b-cli-state-"));
vault = join(tmp, "vault");
mkdirSync(join(vault, "Brain"), { recursive: true });
});
afterEach(() => {
rmSync(tmp, { recursive: true, force: true });
});
test("set overwrites, get and list read, clear removes", async () => {
const set1 = await runCli([
"brain",
"state",
"set",
"--vault",
vault,
"--aspect",
"branch",
"--value",
"feat/x",
]);
expect(set1.returncode).toBe(0);
const set2 = await runCli([
"brain",
"state",
"set",
"--vault",
vault,
"--aspect",
"branch",
"--value",
"feat/y",
]);
expect(set2.returncode).toBe(0);
const get = await runCli([
"brain",
"state",
"get",
"--vault",
vault,
"--aspect",
"branch",
"--json",
]);
expect(get.returncode).toBe(0);
expect(JSON.parse(get.stdout).value).toBe("feat/y");
const list = await runCli(["brain", "state", "list", "--vault", vault, "--json"]);
expect(JSON.parse(list.stdout).aspects.map((a: { aspect: string }) => a.aspect)).toEqual([
"branch",
]);
const clear = await runCli([
"brain",
"state",
"clear",
"--vault",
vault,
"--aspect",
"branch",
"--json",
]);
expect(JSON.parse(clear.stdout).cleared).toBe(true);
const getAfter = await runCli([
"brain",
"state",
"get",
"--vault",
vault,
"--aspect",
"branch",
"--json",
]);
expect(JSON.parse(getAfter.stdout).present).toBe(false);
});
test("set without --aspect is a usage error (exit 2)", async () => {
const res = await runCli(["brain", "state", "set", "--vault", vault, "--value", "x"]);
expect(res.returncode).toBe(2);
});
test("unknown subcommand is a usage error (exit 2)", async () => {
const res = await runCli(["brain", "state", "frobnicate", "--vault", vault]);
expect(res.returncode).toBe(2);
});
test("an invalid aspect fails cleanly (exit 1) instead of crashing, across set/get/clear", async () => {
// Sequential awaits (not Promise.all): runCli's in-process path swaps global
// process.env/cwd, so concurrent calls would corrupt each other's isolation.
// A typed operational failure is exit 1 - not an uncaught-exception crash.
const bad = ["--vault", vault, "--aspect", "bad/aspect"];
const setRes = await runCli(["brain", "state", "set", ...bad, "--value", "x"]);
expect(setRes.returncode).toBe(1);
const getRes = await runCli(["brain", "state", "get", ...bad]);
expect(getRes.returncode).toBe(1);
const clearRes = await runCli(["brain", "state", "clear", ...bad]);
expect(clearRes.returncode).toBe(1);
});
test("an invalid aspect under --json emits the { ok: false } envelope", async () => {
const res = await runCli([
"brain",
"state",
"set",
"--vault",
vault,
"--aspect",
"bad/aspect",
"--value",
"x",
"--json",
]);
expect(res.returncode).toBe(1);
const payload = JSON.parse(res.stdout);
expect(payload.ok).toBe(false);
expect(typeof payload.message).toBe("string");
});