usebruno/bruno · error · Error

No stored spec file found. Please sync with remote spec firs

Error message

No stored spec file found. Please sync with remote spec first.

What it means

Error "No stored spec file found. Please sync with remote spec first." thrown in usebruno/bruno.

Source

Thrown at packages/bruno-electron/src/ipc/openapi-sync.js:867

      if (removedFields.length) changes.push(`-${removedFields.length} form fields`);
    }
    if (jsonBodyDiff) changes.push('body schema');
  }

  return { hasDiff, changes };
};

/**
 * Load the stored spec for a collection and convert it to Bruno collection format.
 * Throws if no stored spec file exists.
 */
const loadStoredSpecCollection = (collectionPath, brunoConfig) => {
  const sourceUrl = brunoConfig?.openapi?.[0]?.sourceUrl;
  const specEntry = sourceUrl ? getSpecEntryForUrl(collectionPath) : null;
  const specPath = specEntry ? path.join(getSpecsDir(), specEntry.filename) : null;

  if (!specPath || !fs.existsSync(specPath)) {
    throw new Error('No stored spec file found. Please sync with remote spec first.');
  }

  const specRaw = fs.readFileSync(specPath, 'utf8');
  const storedSpec = parseSpec(specRaw);
  const groupBy = brunoConfig?.openapi?.[0]?.groupBy || 'tags';
  return openApiToBruno(storedSpec, { groupBy });
};

const registerOpenAPISyncIpc = (mainWindow) => {
  ipcMain.handle('renderer:check-openapi-updates', async (event, {
    collectionUid, collectionPath, sourceUrl, storedSpecHash, environmentContext
  }) => {
    try {
      const result = await fetchSpecFromSource({ collectionUid, collectionPath, sourceUrl, environmentContext });
      if (result.error) {
        return { hasUpdates: false, error: result.error, errorCode: result.errorCode };
      }
      const remoteSpecHash = generateSpecHash(result.spec);

View on GitHub (pinned to 9bdd81c7bd)

Solutions

1. Run a sync with the remote spec first to store a local copy.
2. Check the sync configuration points to a reachable spec URL.

When it happens

Trigger: Thrown at packages/bruno-electron/src/ipc/openapi-sync.js:867 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of usebruno/bruno@9bdd81c7bd (2026-08-13). Data as JSON: /api/errors/8a5f9408e25962b7. Report an issue: GitHub.