E_WORKSPACE_EXISTS

— · Resolution

How to recover

Pass `--force` to overwrite, or edit the file directly.

— · The shape

What an instance looks like

throw new AgentryError({
  code: 'E_WORKSPACE_EXISTS',
  phase: 'init',
  message: '…contextual message…',
  context: { /* adapter-specific */ },
  suggestedFix: 'Pass `--force` to overwrite, or edit the file directly.',
  docs: 'https://openagentry.dev/errors/E_WORKSPACE_EXISTS',
});

The context field carries adapter-specific detail (HTTP status, missing env-var names, validation issues). It never contains secret values.

— · See also

Related codes from @openagentry/cli

• E_PLUGIN_NOT_FOUND A plugin declared in `.agentry/workspace.json` is not installed in the workspace.
• E_PLUGIN_BAD_EXPORT Plugin module is missing an adapter shape on its default export.
• E_PLUGIN_CATEGORY_MISMATCH Manifest declares one category but the runtime adapter exports a different one.
• E_PLUGIN_LAYOUT Could not locate the plugin's `package.json` near its resolved entry point.
• E_PLUGIN_PACKAGE_JSON A plugin's package.json is not valid JSON.
• E_PLUGIN_NO_MANIFEST Plugin's package.json is missing the `openagentry` manifest block.
• E_WORKSPACE_CONFIG_READ Could not read `.agentry/workspace.json`.
• E_WORKSPACE_CONFIG_INVALID `.agentry/workspace.json` failed schema validation.