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
/**
* CLI surface for the Open Knowledge Format round-trip:
* `o2b brain okf-export` / `okf-import`. Locks argument shape, the
* trusted vs review staging behaviour, and exit codes; the core has its
* own unit coverage in tests/core/brain/portability/okf.test.ts.
*/
import { afterEach, beforeEach, describe, expect, setDefaultTimeout, test } from "bun:test";
import { chmodSync, existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { appendLogEvent } from "../../src/core/brain/log.ts";
import { withOperationPrivacy } from "../../src/core/store/operation-scope.ts";
import { STORE_ROOT_ENV } from "../../src/core/store/constants.ts";
import { makeStoreEnv, type StoreEnv } from "../core/store/fixtures/store-env.ts";
import { switchDevice } from "../core/brain/store-only/fixtures.ts";
import { CHMOD_CANNOT_DENY } from "../helpers/platform.ts";
import { logShardsOf } from "../core/store/fixtures/log-shards.ts";
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;
let config: string;
beforeEach(() => {
tmp = mkdtempSync(join(tmpdir(), "o2b-okf-cli-"));
vault = join(tmp, "vault");
config = join(tmp, "config.yaml");
});
afterEach(() => rmSync(tmp, { recursive: true, force: true }));
async function bootstrap(): Promise<void> {
const env = { OPEN_SECOND_BRAIN_CONFIG: config };
expect((await runCli(["init", "--vault", vault, "--name", "T"], { env })).returncode).toBe(0);
expect((await runCli(["brain", "init", "--vault", vault], { env })).returncode).toBe(0);
}
describe("o2b brain okf-export / okf-import", () => {
test("export requires --out", async () => {
await bootstrap();
const r = await runCli(["brain", "okf-export"], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).not.toBe(0);
});
test("export then trusted import round-trips a user page", async () => {
await bootstrap();
const env = { OPEN_SECOND_BRAIN_CONFIG: config };
writeFileSync(join(vault, "Note.md"), "---\ntitle: Note\n---\nlinks to [[Other]].\n");
const out = join(tmp, "bundle");
const exp = await runCli(["brain", "okf-export", "--out", out], { env });
expect(exp.returncode).toBe(0);
expect(existsSync(join(out, "okf.json"))).toBe(true);
expect(existsSync(join(out, "concepts/Note.md"))).toBe(true);
const dest = join(tmp, "dest");
const destConfig = join(tmp, "dest-config.yaml");
const destEnv = { OPEN_SECOND_BRAIN_CONFIG: destConfig };
expect(
(await runCli(["init", "--vault", dest, "--name", "D"], { env: destEnv })).returncode,
).toBe(0);
expect((await runCli(["brain", "init", "--vault", dest], { env: destEnv })).returncode).toBe(0);
const imp = await runCli(["brain", "okf-import", out, "--trusted"], { env: destEnv });
expect(imp.returncode).toBe(0);
expect(existsSync(join(dest, "Note.md"))).toBe(true);
expect(readFileSync(join(dest, "Note.md"), "utf8")).toContain("links to [[Other]].");
});
test("default import stages pages under OKF Review/", async () => {
await bootstrap();
const env = { OPEN_SECOND_BRAIN_CONFIG: config };
writeFileSync(join(vault, "Note.md"), "---\ntitle: Note\n---\nbody.\n");
const out = join(tmp, "bundle");
expect((await runCli(["brain", "okf-export", "--out", out], { env })).returncode).toBe(0);
const imp = await runCli(["brain", "okf-import", out], { env });
expect(imp.returncode).toBe(0);
expect(imp.stdout).toContain("review mode");
expect(existsSync(join(vault, "OKF Review", "Note.md"))).toBe(true);
});
test("import rejects a directory that is not an OKF bundle", async () => {
await bootstrap();
const r = await runCli(["brain", "okf-import", tmp], {
env: { OPEN_SECOND_BRAIN_CONFIG: config },
});
expect(r.returncode).not.toBe(0);
});
});
describe("okf-export on a switched machine", () => {
let env: StoreEnv;
beforeEach(() => {
env = makeStoreEnv("o2b-okf-cli-store-");
switchDevice(env.storeRoot);
});
afterEach(() => env.cleanup());
const cliEnv = (): Record<string, string> => ({
OPEN_SECOND_BRAIN_CONFIG: env.configPath,
[STORE_ROOT_ENV]: env.storeRoot,
});
test.each([[[]], [["--include-prompt-derived"]]])(
"one private event is named on stderr and counted in okf.json (flags %j)",
async (flags: string[]) => {
withOperationPrivacy(true, () => {
appendLogEvent(env.vault, {
timestamp: "2026-06-01T09:00:00Z",
eventType: "note",
body: { text: "private diary event" },
});
});
const out = join(env.parent, "bundle");
const r = await runCli(["brain", "okf-export", "--out", out, ...flags], { env: cliEnv() });
expect(r.returncode).toBe(0);
expect(r.stderr).toContain("left 1 private log entry out of log.md");
const manifest = JSON.parse(readFileSync(join(out, "okf.json"), "utf8")) as {
log_private_omitted?: unknown;
};
expect(manifest.log_private_omitted).toBe(1);
},
);
test("nothing private: no notice, and okf.json counts zero", async () => {
appendLogEvent(env.vault, {
timestamp: "2026-06-01T09:00:00Z",
eventType: "note",
body: { text: "a shared event" },
});
const out = join(env.parent, "bundle");
const r = await runCli(["brain", "okf-export", "--out", out], { env: cliEnv() });
expect(r.returncode).toBe(0);
expect(r.stderr).not.toContain("private log entr");
const manifest = JSON.parse(readFileSync(join(out, "okf.json"), "utf8")) as {
log_private_omitted?: unknown;
};
expect(manifest.log_private_omitted).toBe(0);
});
test.skipIf(CHMOD_CANNOT_DENY)(
"an unreadable private log shard fails the verb and writes no bundle",
async () => {
withOperationPrivacy(true, () => {
appendLogEvent(env.vault, {
timestamp: "2026-06-01T09:00:00Z",
eventType: "note",
body: { text: "kept from the bundle" },
});
});
const [shard] = logShardsOf(env.storeRoot, "private");
expect(shard).toBeDefined();
chmodSync(shard!, 0o000);
try {
const out = join(env.parent, "bundle");
const r = await runCli(["brain", "okf-export", "--out", out], { env: cliEnv() });
expect(r.returncode).not.toBe(0);
expect(r.stderr).toMatch(/cannot read log shard\(s\) private\/log\/\S+\.jsonl/);
expect(existsSync(join(out, "okf.json"))).toBe(false);
} finally {
chmodSync(shard!, 0o644);
}
},
);
});