routstrd 0.2.15 → 0.2.16

package/dist/daemon/index.js

@@ -37216,7 +37216,7 @@ var init_dist3 = __esm(() => {
 // src/daemon/index.ts
 init_dist3();
 import { createServer } from "http";
-import { existsSync as existsSync8 } from "fs";
+import { existsSync as existsSync9 } from "fs";
 
 // src/utils/config.ts
 var HOME = process.env.HOME || process.env.USERPROFILE || "";
@@ -42368,6 +42368,76 @@ Installing routstr configuration in ${configPath}...`);
   }
 }
 
+// src/integrations/hermes.ts
+import { existsSync as existsSync8, mkdirSync as mkdirSync5 } from "fs";
+import { readFile as readFile6, writeFile as writeFile6 } from "fs/promises";
+import { dirname as dirname6 } from "path";
+async function installHermesIntegration(config, apiKey, integrationConfig) {
+  const { name, configPath } = integrationConfig;
+  logger3.log(`
+Installing routstr configuration in ${configPath}...`);
+  logger3.log(`Using API key for ${name}`);
+  const baseUrl = getDaemonBaseUrl(config);
+  const baseUrlV1 = `${baseUrl}/v1`;
+  let defaultModel = "minimax-m2.7";
+  try {
+    const data = await callDaemon("/models");
+    const models = data.output?.models || [];
+    if (models.length >= 3) {
+      defaultModel = models[2].id;
+      logger3.log(`Set default model to 3rd available model: ${defaultModel}`);
+    } else if (models.length > 0) {
+      defaultModel = models[0].id;
+      logger3.log(`Only ${models.length} models available, using ${defaultModel} as default.`);
+    } else {
+      logger3.log("No models available from routstr daemon, using fallback default.");
+    }
+  } catch (error) {
+    logger3.error("Failed to fetch models for Hermes integration:", error);
+    logger3.log("Using fallback default model.");
+  }
+  let content2 = "";
+  try {
+    if (existsSync8(configPath)) {
+      content2 = await readFile6(configPath, "utf-8");
+    }
+  } catch (error) {
+    logger3.error(`Error reading ${configPath}, creating new one.`);
+  }
+  content2 = content2.replace(/^model:\n(?:  .*\n)*/gm, "");
+  content2 = content2.replace(/^custom_providers:\n(?:- .*\n(?:  .*\n)*)*/gm, "");
+  content2 = content2.replace(/\n{3,}/g, `
+
+`).trim();
+  const urlDisplay = baseUrl.replace(/^https?:\/\//, "");
+  const modelBlock = `model:
+  default: ${defaultModel}
+  provider: custom
+  base_url: ${baseUrlV1}
+  api_key: ${apiKey}`;
+  const providerBlock = `custom_providers:
+- name: Routstr (${urlDisplay})
+  base_url: ${baseUrlV1}
+  api_key: ${apiKey}
+  model: ${defaultModel}`;
+  const parts = [modelBlock];
+  if (content2) {
+    parts.push(content2);
+  }
+  parts.push(providerBlock);
+  const newContent = parts.join(`
+
+`) + `
+`;
+  try {
+    mkdirSync5(dirname6(configPath), { recursive: true });
+    await writeFile6(configPath, newContent);
+    logger3.log(`Successfully updated ${configPath} with routstr settings.`);
+  } catch (error) {
+    logger3.error(`Failed to write to ${configPath}:`, error);
+  }
+}
+
 // src/integrations/registry.ts
 var CLIENT_CONFIGS = {
   opencode: {
@@ -42389,13 +42459,19 @@ var CLIENT_CONFIGS = {
     clientId: "claude-code",
     name: "Claude Code",
     configPath: join5(process.env.HOME || "", ".claude/settings.json")
+  },
+  hermes: {
+    clientId: "hermes",
+    name: "Hermes",
+    configPath: join5(process.env.HOME || "", ".hermes/config.yaml")
   }
 };
 var CLIENT_INTEGRATIONS = {
   opencode: installOpencodeIntegration,
   "pi-agent": installPiIntegration,
   openclaw: installOpenClawIntegration,
-  "claude-code": installClaudeCodeIntegration
+  "claude-code": installClaudeCodeIntegration,
+  hermes: installHermesIntegration
 };
 async function runIntegrationsForClients(clientIds, config) {
   for (const client2 of clientIds) {
@@ -43299,7 +43375,7 @@ async function main() {
   }));
   Bun.write(PID_FILE, String(process.pid));
   try {
-    if (existsSync8(SOCKET_PATH)) {
+    if (existsSync9(SOCKET_PATH)) {
       Bun.spawn(["rm", SOCKET_PATH]);
     }
   } catch {

package/dist/index.js

@@ -15025,6 +15025,78 @@ Installing routstr configuration in ${configPath}...`);
   }
 }
 
+// src/integrations/hermes.ts
+init_logger();
+init_daemon_client();
+import { existsSync as existsSync8, mkdirSync as mkdirSync5 } from "fs";
+import { readFile as readFile6, writeFile as writeFile6 } from "fs/promises";
+import { dirname as dirname6 } from "path";
+async function installHermesIntegration(config, apiKey, integrationConfig) {
+  const { name, configPath } = integrationConfig;
+  logger.log(`
+Installing routstr configuration in ${configPath}...`);
+  logger.log(`Using API key for ${name}`);
+  const baseUrl = getDaemonBaseUrl(config);
+  const baseUrlV1 = `${baseUrl}/v1`;
+  let defaultModel = "minimax-m2.7";
+  try {
+    const data = await callDaemon("/models");
+    const models = data.output?.models || [];
+    if (models.length >= 3) {
+      defaultModel = models[2].id;
+      logger.log(`Set default model to 3rd available model: ${defaultModel}`);
+    } else if (models.length > 0) {
+      defaultModel = models[0].id;
+      logger.log(`Only ${models.length} models available, using ${defaultModel} as default.`);
+    } else {
+      logger.log("No models available from routstr daemon, using fallback default.");
+    }
+  } catch (error) {
+    logger.error("Failed to fetch models for Hermes integration:", error);
+    logger.log("Using fallback default model.");
+  }
+  let content = "";
+  try {
+    if (existsSync8(configPath)) {
+      content = await readFile6(configPath, "utf-8");
+    }
+  } catch (error) {
+    logger.error(`Error reading ${configPath}, creating new one.`);
+  }
+  content = content.replace(/^model:\n(?:  .*\n)*/gm, "");
+  content = content.replace(/^custom_providers:\n(?:- .*\n(?:  .*\n)*)*/gm, "");
+  content = content.replace(/\n{3,}/g, `
+
+`).trim();
+  const urlDisplay = baseUrl.replace(/^https?:\/\//, "");
+  const modelBlock = `model:
+  default: ${defaultModel}
+  provider: custom
+  base_url: ${baseUrlV1}
+  api_key: ${apiKey}`;
+  const providerBlock = `custom_providers:
+- name: Routstr (${urlDisplay})
+  base_url: ${baseUrlV1}
+  api_key: ${apiKey}
+  model: ${defaultModel}`;
+  const parts = [modelBlock];
+  if (content) {
+    parts.push(content);
+  }
+  parts.push(providerBlock);
+  const newContent = parts.join(`
+
+`) + `
+`;
+  try {
+    mkdirSync5(dirname6(configPath), { recursive: true });
+    await writeFile6(configPath, newContent);
+    logger.log(`Successfully updated ${configPath} with routstr settings.`);
+  } catch (error) {
+    logger.error(`Failed to write to ${configPath}:`, error);
+  }
+}
+
 // src/integrations/registry.ts
 var CLIENT_CONFIGS = {
   opencode: {
@@ -15046,13 +15118,19 @@ var CLIENT_CONFIGS = {
     clientId: "claude-code",
     name: "Claude Code",
     configPath: join3(process.env.HOME || "", ".claude/settings.json")
+  },
+  hermes: {
+    clientId: "hermes",
+    name: "Hermes",
+    configPath: join3(process.env.HOME || "", ".hermes/config.yaml")
   }
 };
 var CLIENT_INTEGRATIONS = {
   opencode: installOpencodeIntegration,
   "pi-agent": installPiIntegration,
   openclaw: installOpenClawIntegration,
-  "claude-code": installClaudeCodeIntegration
+  "claude-code": installClaudeCodeIntegration,
+  hermes: installHermesIntegration
 };
 async function runIntegrationsForClients(clientIds, config) {
   for (const client of clientIds) {
@@ -15162,6 +15240,8 @@ async function addClientAction(options) {
     integrationKeys.push("pi-agent");
   if (options.claudeCode)
     integrationKeys.push("claude-code");
+  if (options.hermes)
+    integrationKeys.push("hermes");
   if (integrationKeys.length > 0) {
     for (const key of integrationKeys) {
       const integrationFn = CLIENT_INTEGRATIONS[key];
@@ -15190,7 +15270,15 @@ async function addClientAction(options) {
     return;
   }
   if (!options.name) {
-    console.error("error: required option '-n, --name <name>' not specified");
+    console.error(`error: either provide a client name or specify an integration flag.
+`);
+    console.error("Options:");
+    console.error("  -n, --name <name>    Client name");
+    console.error("  --opencode           Set up OpenCode integration");
+    console.error("  --openclaw           Set up OpenClaw integration");
+    console.error("  --pi-agent           Set up Pi Agent integration");
+    console.error("  --claude-code        Set up Claude Code integration");
+    console.error("  --hermes             Set up Hermes integration");
     process.exit(1);
   }
   try {
@@ -15221,7 +15309,7 @@ async function addClientAction(options) {
 // src/cli.ts
 init_config();
 init_logger();
-import { existsSync as existsSync9, mkdirSync as mkdirSync5 } from "fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync6 } from "fs";
 import { execSync } from "child_process";
 
 // src/integrations/index.ts
@@ -15245,7 +15333,7 @@ function parseChoice(input) {
     return 1;
   }
   const parsed = Number.parseInt(input, 10);
-  if (!Number.isNaN(parsed) && parsed >= 1 && parsed <= 5) {
+  if (!Number.isNaN(parsed) && parsed >= 1 && parsed <= 6) {
     return parsed;
   }
   return 1;
@@ -15257,14 +15345,16 @@ Choose an integration to set up:`);
   logger.log("2. OpenClaw");
   logger.log("3. Pi");
   logger.log("4. Claude Code");
-  logger.log("5. Skip for now");
+  logger.log("5. Hermes");
+  logger.log("6. Skip for now");
   const answer = await ask("Select integration [1]: ");
   const choice = parseChoice(answer);
   const integrationByChoice = {
     1: "opencode",
     2: "openclaw",
     3: "pi-agent",
-    4: "claude-code"
+    4: "claude-code",
+    5: "hermes"
   };
   const key = integrationByChoice[choice];
   if (!key) {
@@ -15272,7 +15362,7 @@ Choose an integration to set up:`);
     return;
   }
   const integrationConfig = CLIENT_CONFIGS[key];
-  const { client, created } = await addDaemonClient(integrationConfig.name, integrationConfig.clientId);
+  const { client, created } = await addDaemonClient(integrationConfig.name);
   if (created) {
     logger.log(`Created new API key for ${integrationConfig.name}`);
   } else {
@@ -15292,6 +15382,11 @@ Choose an integration to set up:`);
   }
   if (key === "claude-code") {
     await installClaudeCodeIntegration(config, client.apiKey, integrationConfig);
+    return;
+  }
+  if (key === "hermes") {
+    await installHermesIntegration(config, client.apiKey, integrationConfig);
+    return;
   }
 }
 
@@ -15368,7 +15463,7 @@ init_nip98();
 init_esm();
 
 // src/daemon/wallet/cocod-client.ts
-import { existsSync as existsSync8 } from "fs";
+import { existsSync as existsSync9 } from "fs";
 init_logger();
 init_process_lock();
 var DEFAULT_CONFIG_DIR = process.env.COCOD_DIR || `${process.env.HOME || process.env.USERPROFILE || ""}/.cocod`;
@@ -15380,7 +15475,7 @@ function resolveCocodExecutable(cocodPath) {
 async function isCocodInstalled(cocodPath) {
   const executable = resolveCocodExecutable(cocodPath);
   if (executable.includes("/")) {
-    return existsSync8(executable);
+    return existsSync9(executable);
   }
   try {
     const proc = Bun.spawn({
@@ -15396,7 +15491,7 @@ async function isCocodInstalled(cocodPath) {
 // package.json
 var package_default = {
   name: "routstrd",
-  version: "0.2.15",
+  version: "0.2.16",
   module: "src/index.ts",
   type: "module",
   private: false,
@@ -15475,11 +15570,11 @@ async function requireLocalDaemon() {
 }
 async function initDaemon() {
   logger.log("Initializing routstrd...");
-  if (!existsSync9(CONFIG_DIR)) {
-    mkdirSync5(CONFIG_DIR, { recursive: true });
+  if (!existsSync10(CONFIG_DIR)) {
+    mkdirSync6(CONFIG_DIR, { recursive: true });
     logger.log(`Created config directory: ${CONFIG_DIR}`);
   }
-  if (!existsSync9(CONFIG_FILE)) {
+  if (!existsSync10(CONFIG_FILE)) {
     const config2 = {
       ...DEFAULT_CONFIG,
       cocodPath: null
@@ -15603,8 +15698,8 @@ program.command("remote <url>").description("Configure a remote daemon URL").act
     console.error(`Invalid URL: ${url}`);
     process.exit(1);
   }
-  if (!existsSync9(CONFIG_DIR)) {
-    mkdirSync5(CONFIG_DIR, { recursive: true });
+  if (!existsSync10(CONFIG_DIR)) {
+    mkdirSync6(CONFIG_DIR, { recursive: true });
   }
   const config = await loadConfig();
   const updates = { daemonUrl: url };
@@ -15898,7 +15993,7 @@ clientsCmd.command("list").description("List all clients").action(async () => {
 clientsCmd.command("delete <id>").description("Delete a client by its ID").action(async (id) => {
   await deleteClientAction(id);
 });
-clientsCmd.command("add").description("Add a new client or set up client integrations").option("-n, --name <name>", "Client name").option("--opencode", "Set up OpenCode integration").option("--openclaw", "Set up OpenClaw integration").option("--pi-agent", "Set up Pi Agent integration").option("--claude-code", "Set up Claude Code integration").action(async (options) => {
+clientsCmd.command("add").description("Add a new client or set up client integrations").option("-n, --name <name>", "Client name").option("--opencode", "Set up OpenCode integration").option("--openclaw", "Set up OpenClaw integration").option("--pi-agent", "Set up Pi Agent integration").option("--claude-code", "Set up Claude Code integration").option("--hermes", "Set up Hermes integration").action(async (options) => {
   await addClientAction(options);
 });
 var npubsCmd = program.command("npubs").description("Manage npubs on the daemon (admin or user roles)");
@@ -15971,16 +16066,21 @@ npubsCmd.command("register").description("Register yourself as the first admin (
     console.log(`Successfully registered as first admin npub: ${userNpub}`);
   }
 });
-npubsCmd.command("add <npub>").description("Add a npub (hex pubkey or npub1...). First becomes admin, subsequent become user.").action(async (npubArg) => {
+npubsCmd.command("add <npub>").description("Add a npub (hex pubkey or npub1...). Defaults to 'user' role unless --role is specified.").option("-r, --role <role>", "Role for the npub: 'admin' or 'user' (default: 'user')", "user").action(async (npubArg, options) => {
   await ensureDaemonRunning();
   const normalized = normalizeNostrPubkey(npubArg);
   if (!normalized) {
     console.error("Invalid npub value. Use npub1... or 64-char hex pubkey.");
     process.exit(1);
   }
+  if (options.role !== "admin" && options.role !== "user") {
+    console.error("Invalid role. Expected 'admin' or 'user'.");
+    process.exit(1);
+  }
+  const body = { npub: npubFromPubkey(normalized), role: options.role };
   const result = await callDaemon("/npubs", {
     method: "POST",
-    body: { npub: npubFromPubkey(normalized) }
+    body
   });
   if (result.error) {
     console.log(result.error);
@@ -15988,10 +16088,36 @@ npubsCmd.command("add <npub>").description("Add a npub (hex pubkey or npub1...).
   }
   const output = result.output;
   if (output?.npub) {
-    console.log(`${output.added ? "Added" : "Already configured"} npub: ${output.npub}`);
+    console.log(`${output.added ? "Added" : "Already configured"} npub: ${output.npub} [${output.role ?? "user"}]`);
+  }
+});
+npubsCmd.command("update <npub>").description("Update the role of an existing npub (requires admin)").requiredOption("-r, --role <role>", "New role: 'admin' or 'user'").action(async (npubArg, options) => {
+  await ensureDaemonRunning();
+  const normalized = normalizeNostrPubkey(npubArg);
+  if (!normalized) {
+    console.error("Invalid npub value. Use npub1... or 64-char hex pubkey.");
+    process.exit(1);
+  }
+  if (options.role !== "admin" && options.role !== "user") {
+    console.error("Invalid role. Expected 'admin' or 'user'.");
+    process.exit(1);
+  }
+  const result = await callDaemon("/npubs", {
+    method: "PATCH",
+    body: { npub: npubFromPubkey(normalized), role: options.role }
+  });
+  if (result.error) {
+    console.log(result.error);
+    process.exit(1);
+  }
+  const data = result.output ?? result;
+  if (data?.npub) {
+    console.log(`Updated npub ${data.npub} role to '${data.role}'.`);
+  } else {
+    console.log("Npub not found or update failed.");
   }
 });
-npubsCmd.command("delete <npub>").description("Delete an admin npub (hex pubkey or npub1...)").action(async (npubArg) => {
+npubsCmd.command("delete <npub>").description("Delete an npub (hex pubkey or npub1...)").action(async (npubArg) => {
   await ensureDaemonRunning();
   const normalized = normalizeNostrPubkey(npubArg);
   if (!normalized) {
@@ -16167,7 +16293,7 @@ serviceCmd.command("install").description("Install and start routstrd using PM2
     const path = import.meta.require("path");
     daemonPath = path.join(path.dirname(import.meta.url).replace("file://", ""), "daemon", "index.js");
   }
-  if (!existsSync9(daemonPath)) {
+  if (!existsSync10(daemonPath)) {
     console.error(`Could not find daemon at ${daemonPath}. Did you run 'bun run build'?`);
     process.exit(1);
   }
@@ -16305,14 +16431,14 @@ program.command("logs").description("View daemon logs").option("-f, --follow", "
   const yesterday = new Date;
   yesterday.setDate(yesterday.getDate() - 1);
   const yesterdayFile = getLogFileForDate2(yesterday);
-  if (!existsSync9(todayFile) && !existsSync9(yesterdayFile)) {
+  if (!existsSync10(todayFile) && !existsSync10(yesterdayFile)) {
     console.log("No log files found. Daemon may not have started yet.");
     console.log(`Logs directory: ${LOGS_DIR2}`);
     process.exit(1);
   }
   const lines = parseInt(options.lines, 10);
   const logFiles = [yesterdayFile, todayFile].filter((file, index, files) => {
-    return existsSync9(file) && files.indexOf(file) === index;
+    return existsSync10(file) && files.indexOf(file) === index;
   });
   if (options.follow) {
     const proc2 = Bun.spawn(["tail", "-n", String(lines), "-f", todayFile], {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "routstrd",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "module": "src/index.ts",
   "type": "module",
   "private": false,

package/src/cli.ts

@@ -820,6 +820,7 @@ clientsCmd
   .option("--openclaw", "Set up OpenClaw integration")
   .option("--pi-agent", "Set up Pi Agent integration")
   .option("--claude-code", "Set up Claude Code integration")
+  .option("--hermes", "Set up Hermes integration")
   .action(
     async (options: {
       name?: string;
@@ -827,6 +828,7 @@ clientsCmd
       openclaw?: boolean;
       piAgent?: boolean;
       claudeCode?: boolean;
+      hermes?: boolean;
     }) => {
       await addClientAction(options);
     },
@@ -930,35 +932,75 @@ npubsCmd
 
 npubsCmd
   .command("add <npub>")
-  .description("Add a npub (hex pubkey or npub1...). First becomes admin, subsequent become user.")
-  .action(async (npubArg: string) => {
+  .description("Add a npub (hex pubkey or npub1...). Defaults to 'user' role unless --role is specified.")
+  .option("-r, --role <role>", "Role for the npub: 'admin' or 'user' (default: 'user')", "user")
+  .action(async (npubArg: string, options: { role: string }) => {
     await ensureDaemonRunning();
     const normalized = normalizeNostrPubkey(npubArg);
     if (!normalized) {
       console.error("Invalid npub value. Use npub1... or 64-char hex pubkey.");
       process.exit(1);
     }
+    if (options.role !== "admin" && options.role !== "user") {
+      console.error("Invalid role. Expected 'admin' or 'user'.");
+      process.exit(1);
+    }
+    const body: Record<string, string> = { npub: npubFromPubkey(normalized), role: options.role };
     const result = await callDaemon("/npubs", {
       method: "POST",
-      body: { npub: npubFromPubkey(normalized) },
+      body,
     });
     if (result.error) {
       console.log(result.error);
       process.exit(1);
     }
     const output = result.output as
-      | { npub?: string; added?: boolean; error?: string }
+      | { npub?: string; role?: string; added?: boolean; error?: string }
       | undefined;
     if (output?.npub) {
       console.log(
-        `${output.added ? "Added" : "Already configured"} npub: ${output.npub}`,
+        `${output.added ? "Added" : "Already configured"} npub: ${output.npub} [${output.role ?? "user"}]`,
       );
     }
   });
 
+npubsCmd
+  .command("update <npub>")
+  .description("Update the role of an existing npub (requires admin)")
+  .requiredOption("-r, --role <role>", "New role: 'admin' or 'user'")
+  .action(async (npubArg: string, options: { role: string }) => {
+    await ensureDaemonRunning();
+    const normalized = normalizeNostrPubkey(npubArg);
+    if (!normalized) {
+      console.error("Invalid npub value. Use npub1... or 64-char hex pubkey.");
+      process.exit(1);
+    }
+    if (options.role !== "admin" && options.role !== "user") {
+      console.error("Invalid role. Expected 'admin' or 'user'.");
+      process.exit(1);
+    }
+    const result = await callDaemon("/npubs", {
+      method: "PATCH",
+      body: { npub: npubFromPubkey(normalized), role: options.role },
+    });
+    if (result.error) {
+      console.log(result.error);
+      process.exit(1);
+    }
+    // PATCH /npubs returns { npub, pubkey, role } at the top level, not wrapped in { output }
+    const data = (result.output ?? result) as
+      | { npub?: string; pubkey?: string; role?: string; error?: string }
+      | undefined;
+    if (data?.npub) {
+      console.log(`Updated npub ${data.npub} role to '${data.role}'.`);
+    } else {
+      console.log("Npub not found or update failed.");
+    }
+  });
+
 npubsCmd
   .command("delete <npub>")
-  .description("Delete an admin npub (hex pubkey or npub1...)")
+  .description("Delete an npub (hex pubkey or npub1...)")
   .action(async (npubArg: string) => {
     await ensureDaemonRunning();
     const normalized = normalizeNostrPubkey(npubArg);

package/src/integrations/hermes.ts

@@ -0,0 +1,87 @@
+import { existsSync, mkdirSync } from "fs";
+import { readFile, writeFile } from "fs/promises";
+import { dirname } from "path";
+import type { RoutstrdConfig } from "../utils/config";
+import { logger } from "../utils/logger";
+import type { IntegrationConfig, RoutstrModel } from "./registry";
+import { callDaemon, getDaemonBaseUrl } from "../utils/daemon-client";
+
+export async function installHermesIntegration(
+  config: RoutstrdConfig,
+  apiKey: string,
+  integrationConfig: IntegrationConfig,
+): Promise<void> {
+  const { name, configPath } = integrationConfig;
+
+  logger.log(`\nInstalling routstr configuration in ${configPath}...`);
+  logger.log(`Using API key for ${name}`);
+
+  const baseUrl = getDaemonBaseUrl(config);
+  const baseUrlV1 = `${baseUrl}/v1`;
+
+  let defaultModel = "minimax-m2.7";
+
+  try {
+    const data = await callDaemon("/models");
+    const models = (data.output as { models: RoutstrModel[] } | undefined)?.models || [];
+
+    if (models.length >= 3) {
+      defaultModel = models[2]!.id;
+      logger.log(`Set default model to 3rd available model: ${defaultModel}`);
+    } else if (models.length > 0) {
+      defaultModel = models[0]!.id;
+      logger.log(`Only ${models.length} models available, using ${defaultModel} as default.`);
+    } else {
+      logger.log("No models available from routstr daemon, using fallback default.");
+    }
+  } catch (error) {
+    logger.error("Failed to fetch models for Hermes integration:", error);
+    logger.log("Using fallback default model.");
+  }
+
+  let content = "";
+  try {
+    if (existsSync(configPath)) {
+      content = await readFile(configPath, "utf-8");
+    }
+  } catch (error) {
+    logger.error(`Error reading ${configPath}, creating new one.`);
+  }
+
+  // Remove existing model block
+  content = content.replace(/^model:\n(?:  .*\n)*/gm, "");
+  // Remove existing custom_providers block
+  content = content.replace(/^custom_providers:\n(?:- .*\n(?:  .*\n)*)*/gm, "");
+  // Clean up extra blank lines
+  content = content.replace(/\n{3,}/g, "\n\n").trim();
+
+  const urlDisplay = baseUrl.replace(/^https?:\/\//, "");
+
+  const modelBlock = `model:
+  default: ${defaultModel}
+  provider: custom
+  base_url: ${baseUrlV1}
+  api_key: ${apiKey}`;
+
+  const providerBlock = `custom_providers:
+- name: Routstr (${urlDisplay})
+  base_url: ${baseUrlV1}
+  api_key: ${apiKey}
+  model: ${defaultModel}`;
+
+  const parts: string[] = [modelBlock];
+  if (content) {
+    parts.push(content);
+  }
+  parts.push(providerBlock);
+
+  const newContent = parts.join("\n\n") + "\n";
+
+  try {
+    mkdirSync(dirname(configPath), { recursive: true });
+    await writeFile(configPath, newContent);
+    logger.log(`Successfully updated ${configPath} with routstr settings.`);
+  } catch (error) {
+    logger.error(`Failed to write to ${configPath}:`, error);
+  }
+}

package/src/integrations/registry.ts

@@ -4,6 +4,7 @@ import { installOpencodeIntegration } from "./opencode";
 import { installPiIntegration } from "./pi";
 import { installOpenClawIntegration } from "./openclaw";
 import { installClaudeCodeIntegration } from "./claudecode";
+import { installHermesIntegration } from "./hermes";
 
 export interface IntegrationConfig {
   clientId: string;
@@ -43,6 +44,11 @@ export const CLIENT_CONFIGS: Record<string, IntegrationConfig> = {
     name: "Claude Code",
     configPath: join(process.env.HOME || "", ".claude/settings.json"),
   },
+  hermes: {
+    clientId: "hermes",
+    name: "Hermes",
+    configPath: join(process.env.HOME || "", ".hermes/config.yaml"),
+  },
 };
 
 export const CLIENT_INTEGRATIONS: Record<string, IntegrationFn> = {
@@ -50,6 +56,7 @@ export const CLIENT_INTEGRATIONS: Record<string, IntegrationFn> = {
   "pi-agent": installPiIntegration,
   openclaw: installOpenClawIntegration,
   "claude-code": installClaudeCodeIntegration,
+  hermes: installHermesIntegration,
 };
 
 export async function runIntegrationsForClients(