Fission-AI/OpenSpec · error · StoreError

workset_name_required

workset_name_required

Error message

Pass a workset name.

What it means

Raised by composeFromFlags during 'openspec workset create' when no positional <name> argument was supplied and no interactive prompt is possible. It is a missing-argument validation error pointing at the workset name input; the fix field shows the full command with a name placeholder.

Solutions

1. Run openspec workset create <name> --member <path>
2. Run interactively to be prompted for a name

When it happens

Trigger: Thrown at src/commands/workset.ts:267 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Fission-AI/OpenSpec@6926ccb18a (2026-08-25). Data as JSON: /api/errors/b4f32aa269a90a04. Report an issue: GitHub.

Appendix: source

Thrown at src/commands/workset.ts:267

          await this.open(workset.name, {});
          return;
        }
      }

      console.log(
        `Open it any time with: openspec workset open ${workset.name}`
      );
    } catch (error) {
      emitFailure(options.json, { workset: null, status: [] }, error, 'workset_error');
    }
  }

  private async composeFromFlags(
    name: string | undefined,
    options: WorksetCreateOptions
  ): Promise<Workset> {
    if (!name) {
      throw new StoreError('Pass a workset name.', 'workset_name_required', {
        target: 'workset.name',
        fix: 'openspec workset create <name> --member <path>',
      });
    }

    validateWorksetName(name);

    const memberFlags = options.member ?? [];
    if (memberFlags.length === 0) {
      throw new StoreError(
        'Pass at least one member folder.',
        'workset_members_required',
        {
          target: 'workset.member',
          fix: `openspec workset create ${name} --member <path> --member <name>=<path>`,
        }
      );
    }

View on GitHub (pinned to 6926ccb18a)