{"record":{"id":"ca330426b925f29f","repo":"mastra-ai/mastra","slug":"environment-not-found-envarg-list-environment","errorCode":null,"errorMessage":"Environment not found: ${envArg}. List environments with: mastra env list","messagePattern":"Environment not found: (.+?)\\. List environments with: mastra env list","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/cli/src/commands/db/db.ts","lineNumber":214,"sourceCode":"\nasync function findDatabase(token: string, orgId: string, project: Project, dbArg: string): Promise<ProjectDatabase> {\n  const databases = await fetchDatabases(token, orgId, project.id);\n  const db = databases.find(d => d.id === dbArg || d.name === dbArg);\n  if (!db) {\n    throw new Error(`Database not found: ${dbArg}. List databases with: mastra env db list`);\n  }\n  return db;\n}\n\n/* ------------------------------------------------------------------ */\n/*  mastra env db list                                                 */\n/* ------------------------------------------------------------------ */\n\nasync function findEnvironment(token: string, orgId: string, project: Project, envArg: string): Promise<Environment> {\n  const environments = await fetchEnvironments(token, orgId, project.id);\n  const env = environments.find(e => e.id === envArg || e.name === envArg || e.slug === envArg);\n  if (!env) {\n    throw new Error(`Environment not found: ${envArg}. List environments with: mastra env list`);\n  }\n  return env;\n}\n\nasync function listDatabasesAction(envArg: string | undefined, options: { project?: string; json?: boolean }) {\n  const token = await getToken();\n  const { orgId } = await resolveCurrentOrg(token);\n  const project = await resolveProject(token, orgId, options.project);\n\n  const [databases, environments] = await Promise.all([\n    fetchDatabases(token, orgId, project.id),\n    fetchEnvironments(token, orgId, project.id),\n  ]);\n\n  const env = envArg\n    ? (environments.find(e => e.id === envArg || e.name === envArg || e.slug === envArg) ??\n      (() => {\n        throw new Error(`Environment not found: ${envArg}. List environments with: mastra env list`);","sourceCodeStart":196,"sourceCodeEnd":232,"githubUrl":"https://github.com/mastra-ai/mastra/blob/75dd419e613fe9c39f846ffc500716141b74fda6/packages/cli/src/commands/db/db.ts#L196-L232","documentation":"findEnvironment() resolves envArg against the project's environments by id, name, or slug; when no environment matches it throws with a pointer to `mastra env list`. Used by db subcommands that accept an explicit environment argument.","triggerScenarios":"`mastra env db <cmd> <envArg> ...` where envArg matches no environment id, name, or slug of the resolved project.","commonSituations":"Typo in environment name, environment belongs to a different project (missing --project), or the environment was deleted/renamed by a teammate.","solutions":["Run `mastra env list` and copy the exact environment name/slug.","Pass `--project <name>` if the environment belongs to another project.","Verify the environment still exists; recreate with `mastra env create <name>` if it was deleted."],"exampleFix":"// before\nmastra env db list productoin\n// after\nmastra env db list production","handlingStrategy":"validation","validationCode":"const envs = await listEnvironments(); // or `mastra env list --json`\nif (!envs.some(e => e.id === envArg || e.name === envArg || e.slug === envArg)) {\n  throw new Error(`Unknown environment \"${envArg}\" — valid: ${envs.map(e => e.slug).join(', ')}`);\n}","typeGuard":null,"tryCatchPattern":"try {\n  await runEnvDbCommand(envArg);\n} catch (e) {\n  if (/Environment not found/.test((e as Error).message)) {\n    console.error('Run `mastra env list` and use an exact id/name/slug; verify --project.');\n  }\n}","preventionTips":["Resolve environment names from `mastra env list` rather than memory.","Include --project in scripts when operating across multiple projects.","Update scripts after environments are renamed or deleted."],"tags":["cli","environment","not-found","cloud"],"backgroundTag":"resource-not-found","analyzedSha":"75dd419e613fe9c39f846ffc500716141b74fda6","analyzedAt":"2026-08-30T00:15:31.844Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}