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 uninstall --target X` — remove what `o2b install --target X` wrote.
*
* o2b uninstall --target X # dry-run
* o2b uninstall --target X --apply # remove per manifest
* o2b uninstall --target X --apply --force-from-snippet
* # remove without manifest
* # (exact-payload match)
*/
import { homedir } from "node:os";
import { parseFlags } from "../argparse.ts";
import { defaultConfigPath } from "../../core/config.ts";
import { resolveInstallVault } from "./install.ts";
import { defaultRegistry } from "../../core/install/registry.ts";
import "../../core/install/adapters/aider.ts";
import "../../core/install/adapters/codex.ts";
import "../../core/install/adapters/copilot-cli.ts";
import "../../core/install/adapters/cursor.ts";
import "../../core/install/adapters/gemini-cli.ts";
import "../../core/install/adapters/generic.ts";
import "../../core/install/adapters/grok.ts";
import "../../core/install/adapters/kiro.ts";
import "../../core/install/adapters/opencode.ts";
import "../../core/install/adapters/pi.ts";
import { InstallError, type InstallEnv } from "../../core/install/types.ts";
import { isInstallTargetId, type InstallTargetId } from "../../core/runtime/host-facts.ts";
import {
instructionBlockTargetFor,
instructionStepNoPrecedenceReason,
readInstructionBlockLock,
uninstallInstructionBlock,
} from "../../core/install/instruction-block.ts";
/**
* The reverse instruction step, against the ownership lock (t_ba41a78a
* B3): remove the usage block pair from the instruction file this
* target's host reads, but ONLY when the lock recorded it - a pair
* nobody recorded is not proven ours, and uninstall never removes
* operator content on a guess. Every non-removal outcome is a named
* skip rendered beside the adapter's own.
*/
function uninstallInstructionStep(
env: InstallEnv,
target: string,
dryRun: boolean,
): { file: string | null; removed: boolean; skipped_reason: string | null } {
const mapped = isInstallTargetId(target) ? instructionBlockTargetFor(target) : null;
if (mapped === null) {
return {
file: null,
removed: false,
skipped_reason: instructionStepNoPrecedenceReason(target as InstallTargetId),
};
}
const recorded = readInstructionBlockLock(env.vault).files[mapped] !== undefined;
if (!recorded) {
return {
file: mapped,
removed: false,
skipped_reason: `no lock-recorded instruction block in ${mapped}`,
};
}
const result = uninstallInstructionBlock(env, mapped, { dryRun });
return result.removed
? { file: mapped, removed: true, skipped_reason: null }
: {
file: mapped,
removed: false,
skipped_reason: `${mapped} carries no usage block pair`,
};
}
export async function cmdUninstallTarget(argv: string[]): Promise<number> {
const { flags } = parseFlags(argv, {
target: { type: "string", required: true },
apply: { type: "boolean" },
"force-from-snippet": { type: "boolean" },
config: { type: "string" },
vault: { type: "string" },
json: { type: "boolean" },
});
const target = flags["target"] as string;
const adapter = defaultRegistry.get(target);
if (!adapter) {
process.stderr.write(
`error: unknown --target: ${target}. ` +
`Available: ${defaultRegistry.targets().join(", ")}\n`,
);
return 2;
}
const dryRun = !flags["apply"];
// The vault resolves through the SAME chain the install verb uses
// (`resolveInstallVault`: --vault, then VAULT_DIR, the project pointer,
// the active profile, the config vault key). The old local chain here
// read the config key BEFORE VAULT_DIR - the exact split install.ts
// documents as fixed - so an install that resolved VAULT_DIR was
// uninstalled from the configured vault, where the install manifest is
// absent and the removal refuses while the real install state stays.
const cfgPath = (flags["config"] as string | undefined) ?? defaultConfigPath();
const vault = resolveInstallVault((flags["vault"] as string | null) ?? null, cfgPath);
if (!vault) {
process.stderr.write(
"error: vault not configured. Pass --vault <path>, set VAULT_DIR, or run `o2b init`.\n",
);
return 2;
}
const env: InstallEnv = {
vault,
home: homedir(),
cwd: process.cwd(),
env: { ...process.env } as Record<string, string>,
now: new Date(),
};
const opts = {
dryRun,
force: false,
stdout: process.stdout as NodeJS.WriteStream,
stderr: process.stderr as NodeJS.WriteStream,
fromSnippet: Boolean(flags["force-from-snippet"]),
};
try {
const result = adapter.uninstall(env, opts);
const instruction = uninstallInstructionStep(env, target, dryRun);
if (flags["json"]) {
process.stdout.write(
JSON.stringify({ ...result, instruction_block: instruction }, null, 2) + "\n",
);
return 0;
}
const lines: string[] = [];
lines.push(`o2b uninstall --target ${target}` + (dryRun ? " (dry-run)" : " --apply"));
if (instruction.removed) {
lines.push(` removed instruction block: ${instruction.file}`);
} else if (instruction.skipped_reason !== null) {
lines.push(` skipped: instruction block (${instruction.skipped_reason})`);
}
if (result.removed_keys.length > 0) {
lines.push(" removed keys:");
for (const k of result.removed_keys) lines.push(` - ${k}`);
}
if (result.removed_paths.length > 0) {
lines.push(" removed paths:");
for (const p of result.removed_paths) lines.push(` - ${p}`);
}
if (result.skipped.length > 0) {
lines.push(" skipped:");
for (const [what, why] of result.skipped) lines.push(` - ${what} (${why})`);
}
if (
result.removed_keys.length === 0 &&
result.removed_paths.length === 0 &&
result.skipped.length === 0
) {
lines.push(" (nothing to do)");
}
lines.push("");
process.stdout.write(lines.join("\n"));
return 0;
} catch (e) {
if (e instanceof InstallError) {
process.stderr.write(`error: ${e.message}\n`);
if (e.hint) process.stderr.write(`hint: ${e.hint}\n`);
return e.kind === "manifest-missing" ? 2 : 1;
}
process.stderr.write(`error: ${(e as Error).message}\n`);
return 1;
}
}