Skip to content

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
2.1 KB
Raw Blame
/**
 * `o2b brain token-footprint` - report vault token size per category
 * with an optional warn threshold. Default output is a one-line
 * summary plus a per-category table; `--json` emits the full report
 * for programmatic consumers (cron digests, dashboards).
 */

import { computeTokenFootprint } from "../../../core/brain/token-footprint.ts";
import { brainVerbContext, fail, okJson, parse } from "../helpers.ts";

export async function cmdBrainTokenFootprint(argv: string[]): Promise<number> {
  const { flags } = parse(argv, {
    vault: { type: "string" },
    json: { type: "boolean" },
    "warn-threshold": { type: "string" },
  });
  const { vault } = brainVerbContext(flags);
  const overrideRaw = flags["warn-threshold"] as string | undefined;
  let warnThreshold: number | undefined;
  if (overrideRaw !== undefined) {
    const parsed = Number(overrideRaw);
    if (!Number.isInteger(parsed) || parsed <= 0) {
      return fail(
        `brain token-footprint: --warn-threshold must be a positive integer; got ${overrideRaw}`,
      );
    }
    warnThreshold = parsed;
  }

  const report = computeTokenFootprint(vault, {
    ...(warnThreshold !== undefined ? { warnThreshold } : {}),
    envWarnThreshold: process.env["BRAIN_TOKEN_WARN_THRESHOLD"],
  });

  if (flags["json"]) {
    okJson({
      total: report.total,
      files: report.files,
      warn_threshold: report.warnThreshold,
      exceeded: report.exceeded,
      by_category: report.byCategory.map((c) => ({
        name: c.name,
        tokens: c.tokens,
        files: c.files,
      })),
    });
    return 0;
  }

  process.stdout.write(`total tokens: ${report.total} (across ${report.files} file(s))\n`);
  process.stdout.write(`warn threshold: ${report.warnThreshold}\n`);
  if (report.exceeded) {
    process.stdout.write(`WARN: vault exceeds ${report.warnThreshold} tokens\n`);
  }
  process.stdout.write("\nby category:\n");
  for (const c of report.byCategory) {
    process.stdout.write(
      `  ${c.name.padEnd(12)} ${String(c.tokens).padStart(10)} tokens  (${c.files} file(s))\n`,
    );
  }
  return 0;
}