NousResearch/hermes-agent · error

Active Hermes profile changed while connecting

Error message

Active Hermes profile changed while connecting

What it means

Error "Active Hermes profile changed while connecting" thrown in NousResearch/hermes-agent.

Source

Thrown at apps/desktop/src/store/projects.ts:366

): Promise<T> {
  return gateway.request<T>(method, params)
}

interface ActiveProjectsContext {
  gateway: HermesGateway
  profile: string
}

async function activeProjectsContext(): Promise<ActiveProjectsContext> {
  const profile = $activeGatewayProfile.get() || 'default'
  let gateway = activeGateway()

  if (!gateway || gateway.connectionState !== 'open') {
    gateway = await ensureActiveGatewayOpen()
  }

  if (!gateway || gateway !== activeGateway() || profile !== ($activeGatewayProfile.get() || 'default')) {
    throw new Error('Active Hermes profile changed while connecting')
  }

  return { gateway, profile }
}

function applyPayload(payload: ProjectsPayload): void {
  $projects.set(payload.projects ?? [])
  $activeProjectId.set(payload.active_id ?? null)
}

// Pull the full project list + active pointer. Best-effort: a failure (gateway
// not up yet) leaves the cached atoms intact so the sidebar doesn't flicker.
export async function refreshProjects(): Promise<void> {
  try {
    applyPayload(await gatewayRequest<ProjectsPayload>('projects.list'))
    markProjectsRpcSuccess()
  } catch (err) {
    markProjectsRpcFailure(err)

View on GitHub (pinned to c896c09c42)

Solutions

1. Retry the connection after the active profile settles.
2. Avoid switching profiles while a connection attempt is in flight.

When it happens

Trigger: Thrown at apps/desktop/src/store/projects.ts:366 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of NousResearch/hermes-agent@c896c09c42 (2026-08-14). Data as JSON: /api/errors/687ceed96f539ab6. Report an issue: GitHub.