feat(project): create multiple projects in one command

[betegon]

Summary

sentry project create can create several projects in one command by accepting project names as variadic positional arguments. The trailing positional is the platform, or the platform can be supplied with --platform / -p.

This also tightens the input and output contracts found while reviewing the original CLI-1YY scenario: quoted display names and commas are preserved as one project name, unrelated API 400 responses remain ApiErrors, and multi-project JSON is emitted as one parseable array.

Usage

# Create one project (existing form remains supported)
sentry project create my-app node

# A quoted multi-word display name is one project
sentry project create "My App" node

# Create three projects with the same platform
sentry project create web api worker node

# Equivalent form with an explicit platform flag
sentry project create web api worker --platform node

# Resolve the organization explicitly; all names use the same org
sentry project create acme/web api worker node

# Commas are preserved as part of a single display name
sentry project create payments,eu node

# A batch is returned as one JSON array
sentry project create web api worker node --json

The distinction is based on shell arguments, not string contents:

• "Web API" is one display name and becomes a slug such as web-api.
• web api is two project names.
• payments,eu remains one project name; commas do not split positionals.

What changed

• Resolves the platform from the trailing positional while keeping --platform as an alternative.
• Creates projects sequentially under one organization and shares auto-created team selection across the batch.
• Preserves the historical JSON object for a single project; complete and partial batches use one JSON array.
• Emits projects created before a later failure, then returns the original error, so retries do not hide partial mutations.
• Uses Stricli customUsage so native help, sentry help, generated docs, and the bundled skill show the required platform syntax.
• Removes comma splitting and the heuristic that reclassified any API 400 for a multi-word display name.

Test plan

• pnpm exec vitest run test/commands/project/create.test.ts test/lib/command.test.ts test/lib/introspect.test.ts test/lib/help-positional.test.ts test/script/generate-skill-markdown.test.ts — 170 passed.
• pnpm run typecheck
• pnpm run lint
• pnpm run check:errors
• pnpm run check:fragments
• pnpm run check:deps

The full unit run reached 8,413 passing tests. Its remaining failures are outside this diff: the API-schema and shell-completion failures reproduce on the original PR head, timezone-sensitive cases pass with TZ=UTC, and the untouched wizard auth test has a pre-existing async race.

Related Sentry issue: CLI-1YY

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://cli.sentry.dev/_preview/pr-1191/
Built to branch gh-pages at 2026-07-20 10:46 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[github-actions]

Codecov Results 📊

✅ Patch coverage is 92.47%. Project has 5475 uncovered lines.
✅ Project coverage is 81.71%. Comparing base (base) to head (head).

Files with missing lines (2)

File	Patch %	Lines
src/commands/project/create.ts	91.67%	⚠️ 7 Missing and 9 partials
script/generate-skill-markdown.ts	100.00%	⚠️ 1 partials

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    81.67%    81.71%    +0.04%
==========================================
  Files          426       427        +1
  Lines        29896     29931       +35
  Branches     19420     19450       +30
==========================================
+ Hits         24416     24456       +40
- Misses        5480      5475        -5
- Partials      2035      2039        +4

---

Generated by Codecov Action

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 3ea97b8. Configure here.}