Skip to content

Conversation

@BYK
Copy link
Member

@BYK BYK commented Feb 2, 2026

Summary

Replace verbose --org and --project flags with GitHub-style positional arguments for issue list and project list commands, inspired by the gh CLI.

Before:

sentry issue list --org sentry --project cli
sentry project list --org sentry

After:

sentry issue list sentry/cli     # explicit org and project
sentry issue list sentry/        # all projects in org  
sentry issue list cli            # find project across all orgs
sentry project list sentry       # list projects in org

Changes

  • Add parseOrgProjectArg() utility for parsing <org>/<project> patterns
  • Add findProjectsBySlug() API function to search projects across orgs
  • Refactor issue list to use positional argument instead of flags
  • Refactor project list to use positional argument instead of flag
  • Change cross-org collision alias separator from : to / (e.g., o1/d instead of o1:d)
  • Update help text and error messages
  • Add tests for new functionality

Breaking Changes

  • --org and --project flags removed from sentry issue list
  • --org flag removed from sentry project list

Replace --org and --project flags with GitHub-style positional arguments
for issue list and project list commands.

New syntax:
- `sentry issue list <org>/<project>` - explicit target
- `sentry issue list <org>/` - all projects in org
- `sentry issue list <project>` - find project across orgs
- `sentry project list <org>` - list projects in org

Also changes cross-org collision aliases from colon to slash
separator (e.g., `o1/d` instead of `o1:d`) for consistency.

BREAKING CHANGE: --org and --project flags removed from issue list
and --org flag removed from project list commands.
@github-actions
Copy link

github-actions bot commented Feb 2, 2026

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


New Features ✨

  • (commands) Use positional args for org/project selection by BYK in #155
  • (feedback) Add command to submit CLI feedback by betegon in #150
  • (telemetry) Add is_self_hosted tag by BYK in #153
  • (upgrade) Add self-update command by betegon in #132
  • Add update available notification by BYK in #151

Bug Fixes 🐛

  • (telemetry) Capture command errors to Sentry by betegon in #145
  • Update docs URL in help output by betegon in #149

Documentation 📚

  • (upgrade) Add documentation for upgrade command by betegon in #152
  • Update README and AGENTS.md by betegon in #148

Internal Changes 🔧

  • Move feedback and upgrade under sentry cli command by BYK in #154

🤖 This preview updates automatically when you update the PR.

@github-actions
Copy link

github-actions bot commented Feb 2, 2026

Codecov Results 📊

✅ Patch coverage is 97.92%. Project has 1959 uncovered lines.
✅ Project coverage is 69.68%. Comparing base (base) to head (head).

Files with missing lines (28)
File Patch % Lines
human.ts 31.87% ⚠️ 682 Missing
resolve-target.ts 26.39% ⚠️ 251 Missing
oauth.ts 25.10% ⚠️ 194 Missing
upgrade.ts 39.76% ⚠️ 153 Missing
api-client.ts 73.64% ⚠️ 141 Missing
resolver.ts 3.23% ⚠️ 120 Missing
errors.ts 5.94% ⚠️ 95 Missing
migration.ts 47.44% ⚠️ 82 Missing
api.ts 89.80% ⚠️ 47 Missing
seer.ts 75.54% ⚠️ 45 Missing
seer.ts 79.87% ⚠️ 30 Missing
preload.ts 39.02% ⚠️ 25 Missing
version-check.ts 76.00% ⚠️ 18 Missing
detector.ts 87.79% ⚠️ 16 Missing
schema.ts 64.10% ⚠️ 14 Missing
auth.ts 94.78% ⚠️ 7 Missing
feedback.ts 84.21% ⚠️ 6 Missing
upgrade.ts 93.83% ⚠️ 5 Missing
utils.ts 97.60% ⚠️ 4 Missing
index.ts 95.06% ⚠️ 4 Missing
colors.ts 91.84% ⚠️ 4 Missing
telemetry.ts 97.20% ⚠️ 4 Missing
env-file.ts 97.17% ⚠️ 3 Missing
sentry-urls.ts 88.00% ⚠️ 3 Missing
alias.ts 98.56% ⚠️ 2 Missing
project-aliases.ts 97.40% ⚠️ 2 Missing
java.ts 97.22% ⚠️ 1 Missing
parser.ts 98.63% ⚠️ 1 Missing
Coverage diff
@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    69.39%    69.68%    +0.29%
==========================================
  Files           56        56         —
  Lines         6416      6462       +46
  Branches         0         0         —
==========================================
+ Hits          4452      4503       +51
- Misses        1964      1959        -5
- Partials         0         0         —

Generated by Codecov Action

@BYK BYK requested a review from betegon February 2, 2026 17:34
- Fix JSDoc cross-org example notation (org1:dashboard -> org1/dashboard)
- Add -n short-hand flag for --limit in project list
- Simplify map callback in project list
- Change internal alias map key notation from : to /
- Simplify findProjectsBySlug filter pattern
- Remove ASCII art section dividers from resolve-target.ts
- Add ProjectSpecificationType constant for discriminated union
- Change /cli handling from auto-detect to project-search
- Add prohibited comment styles rule to AGENTS.md
@github-actions
Copy link

github-actions bot commented Feb 2, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://cli.sentry.dev/pr-preview/pr-155/

Built to branch gh-pages at 2026-02-02 19:08 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

- Update project list tests to use positional org arg instead of --org flag
- Update issue list tests to use org/project positional format
- Regenerate SKILL.md
@BYK BYK marked this pull request as ready for review February 2, 2026 20:29
BYK added 2 commits February 2, 2026 20:32
- Add placeholder properties to positional args for better help text
- Add shortcut aliases: -q for query, -s for sort, -n for limit (issue list)
- Add shortcut aliases: -p for platform (project list)
- Add status filtering examples to issue docs (via --query)
- Regenerate SKILL.md with proper argument names
- Add tests for ProjectSpecificationType constant values
- Add tests for findProjectsBySlug function with various scenarios
- Test handling of multiple orgs with matching projects
- Test empty results when no projects match
- Test graceful handling of 403 errors (permission denied)
Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

- Remove ProjectSpecificationType tests (testing constants is useless)
- Fix footer tip to show correct project view syntax
@BYK BYK merged commit b49386c into main Feb 2, 2026
26 of 34 checks passed
@BYK BYK deleted the feat/positional-org-project-args branch February 2, 2026 23:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants