usebruno/bruno · error · Error

Invalid workspace: workspace.yml not found

Error message

Invalid workspace: workspace.yml not found

What it means

Error "Invalid workspace: workspace.yml not found" thrown in usebruno/bruno.

Source

Thrown at packages/bruno-electron/src/ipc/workspace.js:222

        throw new Error('Workspace path is undefined');
      }
      validateWorkspacePath(workspacePath);
      await reorderWorkspaceCollections(workspacePath, collectionPaths);
    } catch (error) {
      throw error;
    }
  });

  ipcMain.handle('renderer:load-workspace-apispecs', async (event, workspacePath) => {
    try {
      if (!workspacePath) {
        throw new Error('Workspace path is undefined');
      }

      const workspaceFilePath = path.join(workspacePath, 'workspace.yml');

      if (!fs.existsSync(workspaceFilePath)) {
        throw new Error('Invalid workspace: workspace.yml not found');
      }

      const yamlContent = fs.readFileSync(workspaceFilePath, 'utf8');
      const workspaceConfig = yaml.load(yamlContent);

      if (!workspaceConfig || typeof workspaceConfig !== 'object') {
        return [];
      }

      const specs = Array.isArray(workspaceConfig.specs) ? workspaceConfig.specs : [];

      const resolvedSpecs = specs
        .map((spec) => {
          if (spec.path && !path.isAbsolute(spec.path)) {
            return {
              ...spec,
              path: path.join(workspacePath, spec.path)
            };

View on GitHub (pinned to 9bdd81c7bd)

Solutions

1. Point to a valid Bruno workspace containing workspace.yml.
2. Create a workspace in that directory first.

When it happens

Trigger: Thrown at packages/bruno-electron/src/ipc/workspace.js:222 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/4b52966eec98c468. Report an issue: GitHub.