@robbiesrobotics/alice-agents 1.5.9 → 1.5.10

package/lib/hermes-installer.mjs

@@ -0,0 +1,338 @@
+// lib/hermes-installer.mjs
+// Installs and configures A.L.I.C.E. for Hermes-only runtime
+
+import { execSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, rmSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const HERMES_DIR = join(homedir(), '.hermes');
+const ALICE_SKILLS_DIR = join(HERMES_DIR, 'skills', 'alice');
+const ALICE_MEMORIES_DIR = join(HERMES_DIR, 'memories', 'alice');
+const ALICE_CONFIG_JSON = join(HERMES_DIR, '.alice-config.json');
+const TEMPLATES_DIR = join(__dirname, '..', 'templates', 'workspaces', '_shared');
+
+// ── Runtime detection ─────────────────────────────────────────────────────────
+
+export function isHermesInstalled() {
+  if (!existsSync(join(homedir(), '.hermes'))) return false;
+  if (!existsSync(join(homedir(), '.hermes', 'config.yaml'))) return false;
+  try {
+    execSync('hermes version', { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function getHermesVersion() {
+  try {
+    // Suppress stderr to avoid "Failed to load config" warnings
+    return execSync('hermes version 2>/dev/null', { encoding: 'utf8', stdio: 'pipe' })
+      .trim()
+      .split('\n')[0]; // only first line
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Read the default model from ~/.hermes/config.yaml
+ * Returns null if no model is configured.
+ */
+export function getHermesDefaultModel() {
+  try {
+    const configPath = join(homedir(), '.hermes', 'config.yaml');
+    const content = readFileSync(configPath, 'utf8');
+    const lines = content.split('\n');
+    let inModel = false;
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (trimmed === 'model:') { inModel = true; continue; }
+      if (inModel) {
+        // 'default: <modelname>' at the same or deeper indent
+        const match = trimmed.match(/^default:\s*(.+)$/);
+        if (match) return match[1].trim();
+        // If we hit a new top-level key, stop
+        if (trimmed.match(/^[a-z]/) && !trimmed.startsWith('default:')) break;
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// ── Hermes config helpers ─────────────────────────────────────────────────────
+// Uses `hermes config set` for safe updates — Hermes rewrites the file correctly.
+
+const ALICE_PERSONALITY = `You are A.L.I.C.E. — the Chief Orchestration Officer of the A.L.I.C.E. multi-agent AI team. Your role is to receive user requests, route them to the right specialist agents (dylan for development, selena for security, devon for DevOps, etc.), wait for their results, and synthesize one clear response. You delegate ALL specialist work — you do not do it yourself. You are sharp, confident, and efficient. Users may call you Alice, A.L.I.C.E., or Olivia.`;
+
+/**
+ * Configure Hermes with alice personality and display settings.
+ * Uses `hermes config set` which safely rewrites the YAML.
+ */
+function configureHermesAlice() {
+  // Set display personality to alice
+  execSync(`hermes config set display.personality alice`, {
+    stdio: 'pipe',
+    env: { ...process.env, TERM: 'xterm-256color' },
+  });
+
+  // Set alice personality
+  execSync(`hermes config set agent.personalities.alice "${ALICE_PERSONALITY.replace(/"/g, '\\"')}"`, {
+    stdio: 'pipe',
+    env: { ...process.env, TERM: 'xterm-256color' },
+  });
+}
+
+// ── Alice skill file generation ───────────────────────────────────────────────
+
+function generateOrchestratorSkill() {
+  const templatePath = join(TEMPLATES_DIR, 'hermes-orchestrator-skill.md');
+  if (!existsSync(templatePath)) {
+    // Fallback inline if template not found
+    return readFileSync(templatePath, 'utf8');
+  }
+  return readFileSync(templatePath, 'utf8');
+}
+
+function generateSpecialistSkill(agentId, agentName, domain, domainDescription) {
+  let templatePath = join(TEMPLATES_DIR, 'hermes-specialist-skill.md');
+  if (!existsSync(templatePath)) {
+    // Inline fallback template
+    return `---
+name: ${agentId}
+description: ${domain} specialist on the A.L.I.C.E. team.
+---
+
+# ${agentName} — ${domain} Specialist
+
+**${agentName}** is a ${domain} specialist on the A.L.I.C.E. team.
+A.L.I.C.E. (orchestrator) assigns you tasks. Complete them and report back.
+
+## Domain
+${domainDescription}
+
+## How You Work
+1. Receive task from A.L.I.C.E.
+2. Use your tools to complete the work
+3. Return structured results to A.L.I.C.E.
+
+## Response Format
+**Summary:** one-line answer
+**Details:** what you did/found
+**Next Steps:** recommended actions
+**Blockers:** anything blocking progress (or "None")
+`;
+  }
+
+  let content = readFileSync(templatePath, 'utf8');
+  content = content
+    .replace(/\{\{agentId\}\}/g, agentId)
+    .replace(/\{\{agentName\}\}/g, agentName)
+    .replace(/\{\{domain\}\}/g, domain)
+    .replace(/\{\{domainDescription\}\}/g, domainDescription || `${domain} specialist work.`);
+  return content;
+}
+
+// ── Alice agent registry ─────────────────────────────────────────────────────
+
+const ALICE_AGENTS = [
+  // Starter agents
+  { id: 'alice', name: 'A.L.I.C.E.', domain: 'Orchestration', isOrchestrator: true, tier: 'core' },
+  { id: 'dylan', name: 'Dylan', domain: 'Development', description: 'Full-stack code, APIs, debugging, architecture, database design', tier: 'starter' },
+  { id: 'selena', name: 'Selena', domain: 'Security', description: 'Security audits, hardening, access controls, incident response, vulnerability assessment', tier: 'starter' },
+  { id: 'devon', name: 'Devon', domain: 'DevOps', description: 'CI/CD pipelines, infrastructure, deployment, Docker, Kubernetes, monitoring', tier: 'starter' },
+  { id: 'quinn', name: 'Quinn', domain: 'QA', description: 'Test design, automation, bug verification, quality assurance, test coverage', tier: 'starter' },
+  { id: 'felix', name: 'Felix', domain: 'Frontend', description: 'UI implementation, React, responsive design, component libraries, CSS', tier: 'starter' },
+  { id: 'daphne', name: 'Daphne', domain: 'Documentation', description: 'API docs, guides, runbooks, READMEs, technical writing', tier: 'starter' },
+  { id: 'rowan', name: 'Rowan', domain: 'Research', description: 'Web research, competitive analysis, fact-finding, technology landscape', tier: 'starter' },
+  { id: 'darius', name: 'Darius', domain: 'Data', description: 'Data pipelines, SQL, analytics, warehousing, ETL processes', tier: 'starter' },
+  { id: 'sophie', name: 'Sophie', domain: 'Support', description: 'Customer support, triage, drafting responses, FAQ creation', tier: 'starter' },
+  // Pro agents
+  { id: 'hannah', name: 'Hannah', domain: 'HR', description: 'Onboarding, HR policy, organizational structure, people operations', tier: 'pro' },
+  { id: 'aiden', name: 'Aiden', domain: 'Analytics', description: 'Dashboards, KPI tracking, business intelligence, analytics models', tier: 'pro' },
+  { id: 'clara', name: 'Clara', domain: 'Communications', description: 'Writing, email sequences, press releases, messaging frameworks', tier: 'pro' },
+  { id: 'avery', name: 'Avery', domain: 'Automation', description: 'Workflow automation, no-code automation, process engineering', tier: 'pro' },
+  { id: 'owen', name: 'Owen', domain: 'Operations', description: 'Vendor management, process efficiency, day-to-day operations', tier: 'pro' },
+  { id: 'isaac', name: 'Isaac', domain: 'Integrations', description: 'API integrations, webhook configurations, third-party connections', tier: 'pro' },
+  { id: 'tommy', name: 'Tommy', domain: 'Travel', description: 'Travel booking, itineraries, logistics, trip planning', tier: 'pro' },
+  { id: 'sloane', name: 'Sloane', domain: 'Sales', description: 'Sales pipeline, outreach, deal management, revenue strategy', tier: 'pro' },
+  { id: 'nadia', name: 'Nadia', domain: 'UI/UX Design', description: 'UX wireframes, visual systems, prototypes, design reviews', tier: 'pro' },
+  { id: 'morgan', name: 'Morgan', domain: 'Marketing', description: 'Content marketing, campaigns, SEO, social media, positioning', tier: 'pro' },
+  { id: 'alex', name: 'Alex', domain: 'API Crawling', description: 'Web scraping, API data extraction, large-scale crawling', tier: 'pro' },
+  { id: 'uma', name: 'Uma', domain: 'UX Research', description: 'User interviews, usability studies, qualitative research, personas', tier: 'pro' },
+  { id: 'caleb', name: 'Caleb', domain: 'CRM', description: 'CRM administration, pipeline management, contact lifecycle', tier: 'pro' },
+  { id: 'elena', name: 'Elena', domain: 'Estimation', description: 'Project estimation, effort scoping, technical planning', tier: 'pro' },
+  { id: 'audrey', name: 'Audrey', domain: 'Accounting', description: 'Financial tracking, budgets, expense management, reconciliation', tier: 'pro' },
+  { id: 'logan', name: 'Logan', domain: 'Legal', description: 'Contract review, terms of service, NDAs, regulatory compliance', tier: 'pro' },
+  { id: 'eva', name: 'Eva', domain: 'Executive Assistant', description: 'Scheduling, meeting preparation, executive briefs, follow-ups', tier: 'pro' },
+  { id: 'parker', name: 'Parker', domain: 'Project Management', description: 'Project milestones, tracking, cross-functional coordination', tier: 'pro' },
+  { id: 'nate', name: 'Nate', domain: 'n8n Automation', description: 'n8n workflow building, node-based automation, workflow design', tier: 'pro' },
+  { id: 'aria', name: 'Aria', domain: 'Autonomous Research', description: 'Deep investigative research, longitudinal studies, synthesis', tier: 'pro' },
+  { id: 'maxxipro', name: 'MaxxiPro', domain: 'Roof Maxx Expert', description: 'Roofing estimation, contracting, roof inspection workflows', tier: 'pro' },
+  { id: 'accuscope', name: 'AccuScope', domain: 'AccuLynx CRM Auditor', description: 'AccuLynx CRM data quality, auditing, pipeline health', tier: 'pro' },
+  { id: 'smoketestagent', name: 'SmokeTestAgent', domain: 'QA Specialist', description: 'Smoke testing, regression testing, automated test suites', tier: 'pro' },
+];
+
+export function getAliceAgents(tier = 'both') {
+  if (tier === 'starter') return ALICE_AGENTS.filter(a => a.tier === 'starter' || a.isOrchestrator);
+  if (tier === 'pro') return ALICE_AGENTS;
+  return ALICE_AGENTS;
+}
+
+// ── Install A.L.I.C.E. on Hermes ─────────────────────────────────────────────
+
+export async function installForHermes(options = {}) {
+  const { tier = 'starter', auto = false, userInfo = null } = options;
+  const agents = getAliceAgents(tier);
+  const result = { skills: [], memories: [], config: null, errors: [] };
+
+  console.log('');
+  console.log(`  ${'─'.repeat(50)}`);
+  console.log(`  ${'🧠'.padStart(15)} ${'A.L.I.C.E. on Hermes'}`);
+  console.log(`  ${'─'.repeat(50)}`);
+  console.log('');
+
+  // 1. Verify Hermes is installed
+  if (!isHermesInstalled()) {
+    throw new Error('Hermes is not installed. Run: curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash');
+  }
+
+  const version = getHermesVersion();
+  console.log(`  ${'✓'.padStart(15)} ${version}`);
+  console.log('');
+
+  // 2. Ensure alice skill directory
+  if (!existsSync(ALICE_SKILLS_DIR)) {
+    mkdirSync(ALICE_SKILLS_DIR, { recursive: true });
+  }
+
+  // 3. Install orchestrator skill
+  console.log(`  ${'─'.repeat(50)}`);
+  console.log(`  ${'🤖'.padStart(15)} ${'A.L.I.C.E. orchestrator skill'}`);
+  console.log(`  ${'─'.repeat(50)}`);
+  const orchestratorDir = join(ALICE_SKILLS_DIR, 'alice');
+  mkdirSync(orchestratorDir, { recursive: true });
+  const orchestratorContent = generateOrchestratorSkill();
+  writeFileSync(join(orchestratorDir, 'SKILL.md'), orchestratorContent, 'utf8');
+  console.log(`  ${'✓'.padStart(15)} alice/SKILL.md — orchestrator`);
+  result.skills.push('alice');
+
+  // 4. Install specialist skills
+  const specialistAgents = agents.filter(a => !a.isOrchestrator);
+  console.log('');
+  console.log(`  ${'─'.repeat(50)}`);
+  console.log(`  ${'👥'.padStart(15)} ${specialistAgents.length} specialist skills`);
+  console.log(`  ${'─'.repeat(50)}`);
+
+  for (const agent of specialistAgents) {
+    const skillDir = join(ALICE_SKILLS_DIR, agent.id);
+    mkdirSync(skillDir, { recursive: true });
+    const skillContent = generateSpecialistSkill(agent.id, agent.name, agent.domain, agent.description || '');
+    writeFileSync(join(skillDir, 'SKILL.md'), skillContent, 'utf8');
+    console.log(`  ${'✓'.padStart(15)} ${agent.id.padEnd(15)} — ${agent.domain}`);
+    result.skills.push(agent.id);
+  }
+
+  // 5. Create memory directories
+  console.log('');
+  console.log(`  ${'─'.repeat(50)}`);
+  console.log(`  ${'🧠'.padStart(15)} ${'Memory directories'}`);
+  console.log(`  ${'─'.repeat(50)}`);
+
+  for (const agent of agents) {
+    const memDir = join(HERMES_DIR, 'memories', agent.id);
+    if (!existsSync(memDir)) {
+      mkdirSync(memDir, { recursive: true });
+    }
+    result.memories.push(agent.id);
+  }
+  console.log(`  ${'✓'.padStart(15)} ${agents.length} memory dirs created`);
+
+  // 6. Patch Hermes config with alice personality
+  console.log('');
+  console.log(`  ${'─'.repeat(50)}`);
+  console.log(`  ${'⚙️'.padStart(15)} ${'Hermes configuration'}`);
+  console.log(`  ${'─'.repeat(50)}`);
+
+  configureHermesAlice();
+  result.config = 'config.yaml updated';
+  console.log(`  ${'✓'.padStart(15)} personality 'alice' added to config.yaml`);
+  console.log(`  ${'✓'.padStart(15)} display.personality set to alice`);
+
+  // 7. Write alice-config.json for installer tracking
+  const aliceConfig = {
+    runtime: 'hermes',
+    version,
+    installedAt: new Date().toISOString(),
+    agents: agents.map(a => a.id),
+    tier,
+    userName: userInfo?.name || 'unknown',
+  };
+  writeFileSync(ALICE_CONFIG_JSON, JSON.stringify(aliceConfig, null, 2), 'utf8');
+
+  console.log('');
+  console.log(`  ${'✓'.padStart(15)} alice-config.json written`);
+  console.log('');
+
+  return result;
+}
+
+// ── Uninstall A.L.I.C.E. from Hermes ────────────────────────────────────────
+
+export function uninstallFromHermes(options = {}) {
+  const { auto = false } = options;
+  const result = { removed: [], errors: [] };
+
+  // Remove alice skill tree
+  if (existsSync(ALICE_SKILLS_DIR)) {
+    rmSync(ALICE_SKILLS_DIR, { recursive: true, force: true });
+    result.removed.push('alice skills');
+  }
+
+  // Remove alice memories
+  const memoriesBase = join(HERMES_DIR, 'memories', 'alice');
+  if (existsSync(memoriesBase)) {
+    rmSync(memoriesBase, { recursive: true, force: true });
+    result.removed.push('alice memories');
+  }
+
+  // Remove config tracking
+  if (existsSync(ALICE_CONFIG_JSON)) {
+    rmSync(ALICE_CONFIG_JSON, { force: true });
+    result.removed.push('alice-config.json');
+  }
+
+  // Remove alice personality using hermes config set (deletes by unsetting)
+  try {
+    // Setting to empty/null effectively removes it
+    execSync(`hermes config set display.personality helpful`, {
+      stdio: 'pipe',
+      env: { ...process.env, TERM: 'xterm-256color' },
+    });
+    result.removed.push('display.personality reset to helpful');
+  } catch (err) {
+    result.errors.push(`display.personality reset: ${err.message}`);
+  }
+
+  return result;
+}
+
+// ── Status ─────────────────────────────────────────────────────────────────────
+
+export function getHermesAliceStatus() {
+  const configPath = join(ALICE_CONFIG_JSON);
+  if (!existsSync(configPath)) {
+    return { installed: false };
+  }
+  try {
+    const data = JSON.parse(readFileSync(configPath, 'utf8'));
+    return { installed: true, ...data };
+  } catch {
+    return { installed: false };
+  }
+}

package/lib/installer.mjs

@@ -39,6 +39,7 @@ import { c, bold, dim, green, greenBold, red, yellow, cyan, gray,
 import { runSkillsWizardStep } from './skills.mjs';
 import { resolveCodingAgentPreference } from './coding-agent.mjs';
 import { loadAgentRegistry } from './agent-registry.mjs';
+import { HermesAgentManager } from './hermes-agent.mjs';
 
 function commandExists(cmd) {
   const probe = process.platform === 'win32' ? 'where' : 'which';
@@ -54,6 +55,105 @@ function isOpenClawInstalled() {
   return commandExists('openclaw');
 }
 
+// ── Hermes detection ─────────────────────────────────────────────────────────
+
+function isHermesInstalled() {
+  if (!existsSync(join(homedir(), '.hermes', 'config.yaml'))) return false;
+  try {
+    execSync('hermes version', { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function getHermesVersion() {
+  try {
+    const output = execSync('hermes version 2>&1', { encoding: 'utf8', stdio: 'pipe' }).trim();
+    return output;
+  } catch {
+    return null;
+  }
+}
+
+async function installHermes(auto) {
+  console.log('');
+  printSection('Installing Hermes Agent');
+  console.log('');
+  console.log(`  ${dim('Hermes Agent is required for the Hermes agent bridge.')}`);
+  console.log(`  ${dim('Install:')} ${cyan('curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash')}`);
+  console.log('');
+
+  if (auto) {
+    console.log(`  ${icons.info} ${dim('Non-interactive: running Hermes install script now...')}`);
+    console.log('');
+    try {
+      execSync('curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash', {
+        stdio: 'inherit',
+        timeout: 120000,
+      });
+      const version = getHermesVersion();
+      if (version) {
+        printStepDone('Hermes installed', version);
+        return { status: 'ok', version };
+      }
+    } catch (err) {
+      console.log(`  ${icons.warn} ${yellow('Hermes install failed.')}`);
+      console.log(`  ${dim('Install manually:')} ${cyan('curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash')}`);
+      return { status: 'error', reason: err.message };
+    }
+  }
+
+  const shouldInstall = await confirm('  Install Hermes Agent now?');
+  if (!shouldInstall) {
+    printStepSkip('Hermes Agent', 'not installed — Hermes agent bridge will be skipped');
+    return { status: 'skipped' };
+  }
+
+  try {
+    execSync('curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash', {
+      stdio: 'inherit',
+      timeout: 120000,
+    });
+    const version = getHermesVersion();
+    if (version) {
+      printStepDone('Hermes installed', version);
+      return { status: 'ok', version };
+    }
+  } catch (err) {
+    console.log(`  ${icons.warn} ${yellow('Hermes install failed: ' + (err.message || 'unknown error'))}`);
+    console.log(`  ${dim('Install manually:')} ${cyan('curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash')}`);
+    return { status: 'error', reason: err.message };
+  }
+
+  return { status: 'ok', version: getHermesVersion() };
+}
+
+async function checkHermes(auto, hermesBridgeRequested) {
+  const hermesFound = isHermesInstalled();
+  const version = hermesFound ? getHermesVersion() : null;
+
+  if (hermesFound && version) {
+    console.log(`  ${icons.ok} ${green('Hermes detected:')} ${version}`);
+    return { status: 'found', version };
+  }
+
+  // Hermes not found
+  if (hermesBridgeRequested) {
+    console.log(`  ${icons.warn} ${yellow('Hermes not found.')}`);
+    console.log(`  ${dim('The --hermes-bridge flag requires Hermes to be installed.')}`);
+    const result = await installHermes(auto);
+    return result;
+  }
+
+  // Hermes not requested — just informational
+  console.log(`  ${icons.info} ${dim('Hermes not found.')}`);
+  console.log(`  ${dim('Hermes enables persistent-memory specialist agents for the A.L.I.C.E. team.')}`);
+  console.log(`  ${dim('Install:')} ${cyan('curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash')}`);
+  console.log(`  ${dim('Or re-run with')} ${cyan('--hermes-bridge')} ${dim('to install automatically.')}`);
+  return { status: 'not_found' };
+}
+
 /**
  * On Linux, Docker requires the user to be in the docker group.
  * Detect this early and warn before OpenClaw's own preflight fails cryptically.
@@ -91,6 +191,16 @@ function checkLinuxDockerPermissions() {
 }
 
 async function detectRuntime() {
+  // Hermes is always standalone — check first
+  const hermesDir = join(homedir(), '.hermes');
+  const hermesConfig = join(hermesDir, 'config.yaml');
+  if (existsSync(hermesConfig)) {
+    try {
+      execSync('hermes version', { stdio: 'pipe' });
+      return 'hermes';
+    } catch {}
+  }
+
   // Check for NemoClaw binary
   try {
     execSync('nemoclaw --version', { stdio: 'pipe' });
@@ -630,6 +740,120 @@ export async function runInstall(options = {}) {
   // 0. Linux Docker permission check — warn early before OpenClaw preflight fails
   checkLinuxDockerPermissions();
 
+  // 1. Detect runtime — Hermes, NemoClaw, OpenClaw, or none
+  const runtime = options.runtimeOverride || await detectRuntime();
+
+  // ── HERMES-ONLY PATH ──────────────────────────────────────────────────────
+  if (runtime === 'hermes') {
+    // Lazy-import to avoid circular deps
+    const { installForHermes, getHermesAliceStatus } = await import('./hermes-installer.mjs');
+    const { detectUserName, detectTimezone } = await import('./prompter.mjs');
+
+    console.log(`  ${icons.ok} ${greenBold('Hermes detected')} ${dim('─')} A.L.I.C.E. will run as a Hermes skill tree\n`);
+
+    // Check if already installed
+    const existingStatus = getHermesAliceStatus();
+    if (existingStatus.installed && manifest && !options.force) {
+      console.log(`  ${icons.info} ${dim('A.L.I.C.E. already installed on Hermes')}`);
+      console.log(`  ${dim('Run with --force to reinstall.')}\n`);
+    }
+
+    // Detect Hermes version and model
+    const { getHermesVersion, getHermesDefaultModel } = await import('./hermes-installer.mjs');
+    const hermesVersion = getHermesVersion();
+    const hermesModel = getHermesDefaultModel();
+    if (hermesVersion) {
+      console.log(`  ${icons.ok} ${green('Hermes version:')} ${hermesVersion}`);
+    }
+    if (hermesModel) {
+      console.log(`  ${icons.ok} ${green('Model:')} ${hermesModel}`);
+    } else {
+      console.log('');
+      console.log(`  ${icons.fail} ${red('No model configured for Hermes')}`);
+      console.log('');
+      console.log(`  ${dim('A model is required before installing A.L.I.C.E.')}`);
+      console.log(`  Run: ${cyan('hermes model')}`);
+      console.log(`  Then re-run: ${cyan('npx @robbiesrobotics/alice-agents --runtime hermes')}`);
+      console.log('');
+      process.exit(1);
+    }
+
+    // 2. Tier selection
+    let tier;
+    if (options.tierOverride) {
+      tier = normalizeTierOption(options.tierOverride);
+    } else if (auto) {
+      tier = 'starter';
+    } else {
+      tier = await promptTier();
+    }
+
+    // 3. User info
+    let userInfo;
+    if (auto) {
+      userInfo = { name: detectUserName(), timezone: detectTimezone(), notes: '' };
+    } else {
+      printSection('About You');
+      console.log('');
+      userInfo = await promptUserInfo();
+    }
+
+    // 4. Confirmation
+    const agents = (await import('./agent-registry.mjs')).loadAgentRegistry(tier);
+    if (!auto) {
+      printSection('Install Summary');
+      console.log('');
+      console.log(`  ${dim('Runtime:')}  ${green('Hermes Agent')}`);
+      console.log(`  ${dim('Model:')}    ${green(hermesModel || 'none')}`);
+      console.log(`  ${dim('Tier:')}     ${green(tier)} ${dim('(' + agents.length + ' agents)')}`);
+      console.log(`  ${dim('User:')}     ${green(userInfo.name)}`);
+      console.log('');
+      const ok = await confirm('  Proceed with Hermes install?');
+      if (!ok) {
+        console.log('  Aborted.');
+        closePrompt();
+        return;
+      }
+    }
+    closePrompt();
+
+    // Execute Hermes install
+    printSection('Installing A.L.I.C.E. on Hermes');
+    console.log('');
+
+    const result = await installForHermes({ tier, auto, userInfo });
+
+    // Write manifest
+    writeManifest({
+      installedAt: existingStatus?.installedAt || new Date().toISOString(),
+      tier,
+      agents: result.skills,
+      userName: userInfo.name,
+      userTimezone: userInfo.timezone,
+      modelPreset: 'hermes-detected',
+      runtime: 'hermes',
+      skills: [],
+      codingTool: null,
+      codingSkill: null,
+      missionControl: null,
+    });
+
+    console.log('');
+    printSeparator();
+    console.log('');
+    console.log(`  ${icons.ok} ${greenBold('A.L.I.C.E. installed on Hermes!')} ${dim(result.skills.length + ' skills ready.')}`);
+    console.log('');
+    console.log(`  ${dim('Start A.L.I.C.E.:')}   ${cyan('hermes chat')}`);
+    console.log(`  ${dim('List skills:')}     ${cyan('hermes skills list')}`);
+    console.log(`  ${dim('Skills dir:')}      ${cyan('~/.hermes/skills/alice/')}`);
+    console.log('');
+    printSeparator();
+    console.log('');
+    return;
+  }
+  // ── END HERMES PATH ────────────────────────────────────────────────────────
+
+  // OpenClaw / NemoClaw path (existing behavior)
   // 1. Detect OpenClaw — offer to install if missing
   if (!isOpenClawInstalled() || !configExists()) {
     await installRuntime(auto);
@@ -645,7 +869,6 @@ export async function runInstall(options = {}) {
   // 1b. Check for OpenClaw updates
   await checkForOpenClawUpdate(auto);
 
-  const runtime = await detectRuntime();
   if (runtime === 'nemoclaw') {
     console.log(`  ${icons.ok} ${greenBold('NemoClaw detected')} ${dim('─')} agents run in OpenShell sandbox\n`);
   } else {
@@ -657,17 +880,26 @@ export async function runInstall(options = {}) {
     }
   }
 
+  // Hermes check (for OpenClaw+Hermes hybrid setups)
+  const hermesResult = await checkHermes(auto, !!options.hermesBridge);
+  const hermesReady = hermesResult.status === 'found' || hermesResult.status === 'ok';
+
   // Detect what models the user already has configured
   const detectedModels = detectAvailableModels();
   if (detectedModels?.hasModel) {
-    console.log(`  ${icons.ok} ${green('Detected configured model:')} ${detectedModels.primary}`);
+    console.log(`  ${icons.ok} ${green('Model:')} ${detectedModels.primary}`);
     if (detectedModels.providers.length > 0) {
-      console.log(`     Providers: ${detectedModels.providers.join(', ')}\n`);
-    } else {
-      console.log();
+      console.log(`     Providers: ${detectedModels.providers.join(', ')}`);
     }
+    console.log('');
   } else {
-    console.log(`  ${icons.info} ${dim('No model configured yet — you\'ll be prompted to choose one.')}\n`);
+    console.log(`  ${icons.fail} ${red('No model configured for OpenClaw')}`);
+    console.log('');
+    console.log(`  ${dim('A model is required before installing A.L.I.C.E.')}`);
+    console.log(`  Run: ${cyan('openclaw configure')}`);
+    console.log(`  Then re-run: ${cyan('npx @robbiesrobotics/alice-agents')}`);
+    console.log('');
+    process.exit(1);
   }
 
   // 2. Install mode
@@ -706,19 +938,9 @@ export async function runInstall(options = {}) {
     userInfo = await promptUserInfo();
   }
 
-  // 4. Model preset
-  let preset, customModels;
-  if (auto) {
-    // Non-interactive: use whatever the user already has configured.
-    // Only fall back to sonnet if nothing is detected (e.g. fresh OpenClaw install
-    // where the user explicitly set up Claude credentials).
-    preset = detectedModels?.hasModel ? 'detected' : 'sonnet';
-  } else {
-    preset = await promptModelPreset(detectedModels);
-    if (preset === 'custom') {
-      customModels = await promptCustomModel();
-    }
-  }
+  // 4. Model — always use whatever is already configured; we already verified one exists above
+  const preset = 'detected';
+  const customModels = null; // not used when preset=detected
 
   // 5. Tier selection
   let tier;
@@ -964,6 +1186,19 @@ export async function runInstall(options = {}) {
     sandboxName: 'my-assistant',
   });
 
+  // Hermes agent bridge setup
+  if (options.hermesBridge && hermesReady) {
+    const hermes = new HermesAgentManager();
+    const bridgeResult = hermes.setupBridge();
+    if (bridgeResult.status === 'ok') {
+      printStepDone('Hermes bridge', `v${bridgeResult.hermesVersion} connected`);
+    } else {
+      printStepSkip('Hermes bridge', bridgeResult.reason);
+    }
+  } else if (options.hermesBridge && !hermesReady) {
+    printStepSkip('Hermes bridge', 'Hermes not installed');
+  }
+
   // Write manifest
   const existing = readManifest();
   writeManifest({