feat(commands): use positional args for org/project selection

AGENTS.md

@@ -292,6 +292,9 @@ return result // return result
 await deleteUserData(userId)
 ```
 
+### Prohibited Comment Styles
+- **ASCII art section dividers** - Do not use decorative box-drawing characters like `─────────` to create section headers. Use standard JSDoc comments or simple `// Section Name` comments instead.
+
 ### Goal
 Minimal comments, maximum clarity. Comments explain **intent and reasoning**, not syntax.
 

docs/src/content/docs/commands/issue.md

@@ -12,24 +12,41 @@ Track and manage Sentry issues.
 List issues in a project.
 
 ```bash
-sentry issue list --org <org-slug> --project <project-slug>
+# Explicit org and project
+sentry issue list <org>/<project>
+
+# All projects in an organization
+sentry issue list <org>/
+
+# Search for project across all accessible orgs
+sentry issue list <project>
+
+# Auto-detect from DSN or config
+sentry issue list
 ```
 
+**Arguments:**
+
+| Argument | Description |
+|----------|-------------|
+| `<org>/<project>` | Explicit organization and project (e.g., `my-org/frontend`) |
+| `<org>/` | All projects in the specified organization |
+| `<project>` | Search for project by name across all accessible organizations |
+
 **Options:**
 
 | Option | Description |
 |--------|-------------|
-| `--org <org-slug>` | Organization slug (required) |
-| `--project <project-slug>` | Project slug (required) |
-| `--query <query>` | Search query |
-| `--status <status>` | Filter by status (unresolved, resolved, ignored) |
-| `--limit <n>` | Maximum number of issues to return |
+| `--query <query>` | Search query (Sentry search syntax) |
+| `--sort <sort>` | Sort by: date, new, freq, user (default: date) |
+| `--limit <n>` | Maximum number of issues to return (default: 10) |
 | `--json` | Output as JSON |
 
-**Example:**
+**Examples:**
 
 ```bash
-sentry issue list --org my-org --project frontend
+# List issues in a specific project
+sentry issue list my-org/frontend
 ```
 
 ```
@@ -38,10 +55,41 @@ ID            SHORT ID    TITLE                           COUNT   USERS
 987654321     FRONT-DEF   ReferenceError: x is not de...  456     89
 ```
 
+**List issues from all projects in an org:**
+
+```bash
+sentry issue list my-org/
+```
+
+**Search for a project across organizations:**
+
+```bash
+sentry issue list frontend
+```
+
 **With search query:**
 
 ```bash
-sentry issue list --org my-org --project frontend --query "TypeError"
+sentry issue list my-org/frontend --query "TypeError"
+```
+
+**Sort by frequency:**
+
+```bash
+sentry issue list my-org/frontend --sort freq --limit 20
+```
+
+**Filter by status:**
+
+```bash
+# Show only unresolved issues
+sentry issue list my-org/frontend --query "is:unresolved"
+
+# Show resolved issues
+sentry issue list my-org/frontend --query "is:resolved"
+
+# Combine with other search terms
+sentry issue list my-org/frontend --query "is:unresolved TypeError"
 ```
 
 ### `sentry issue view`

plugins/sentry-cli/skills/sentry-cli/SKILL.md

@@ -110,7 +110,7 @@ sentry org list
 sentry org list --json
 ```
 
-#### `sentry org view <arg0>`
+#### `sentry org view <org>`
 
 View details of an organization
 
@@ -132,15 +132,14 @@ sentry org view my-org -w
 
 Work with Sentry projects
 
-#### `sentry project list`
+#### `sentry project list <org>`
 
 List projects
 
 **Flags:**
-- `--org <value> - Organization slug`
-- `--limit <value> - Maximum number of projects to list - (default: "30")`
+- `-n, --limit <value> - Maximum number of projects to list - (default: "30")`
 - `--json - Output JSON`
-- `--platform <value> - Filter by platform (e.g., javascript, python)`
+- `-p, --platform <value> - Filter by platform (e.g., javascript, python)`
 
 **Examples:**
 
@@ -155,7 +154,7 @@ sentry project list <org-slug>
 sentry project list --platform javascript
 ```
 
-#### `sentry project view <arg0>`
+#### `sentry project view <project>`
 
 View details of a project
 
@@ -178,29 +177,53 @@ sentry project view frontend -w
 
 Manage Sentry issues
 
-#### `sentry issue list`
+#### `sentry issue list <target>`
 
 List issues in a project
 
 **Flags:**
-- `--org <value> - Organization slug`
-- `--project <value> - Project slug`
-- `--query <value> - Search query (Sentry search syntax)`
-- `--limit <value> - Maximum number of issues to return - (default: "10")`
-- `--sort <value> - Sort by: date, new, freq, user - (default: "date")`
+- `-q, --query <value> - Search query (Sentry search syntax)`
+- `-n, --limit <value> - Maximum number of issues to return - (default: "10")`
+- `-s, --sort <value> - Sort by: date, new, freq, user - (default: "date")`
 - `--json - Output as JSON`
 
 **Examples:**
 
 ```bash
-sentry issue list --org <org-slug> --project <project-slug>
+# Explicit org and project
+sentry issue list <org>/<project>
+
+# All projects in an organization
+sentry issue list <org>/
+
+# Search for project across all accessible orgs
+sentry issue list <project>
+
+# Auto-detect from DSN or config
+sentry issue list
+
+# List issues in a specific project
+sentry issue list my-org/frontend
+
+sentry issue list my-org/
+
+sentry issue list frontend
+
+sentry issue list my-org/frontend --query "TypeError"
+
+sentry issue list my-org/frontend --sort freq --limit 20
+
+# Show only unresolved issues
+sentry issue list my-org/frontend --query "is:unresolved"
 
-sentry issue list --org my-org --project frontend
+# Show resolved issues
+sentry issue list my-org/frontend --query "is:resolved"
 
-sentry issue list --org my-org --project frontend --query "TypeError"
+# Combine with other search terms
+sentry issue list my-org/frontend --query "is:unresolved TypeError"
 ```
 
-#### `sentry issue explain <arg0>`
+#### `sentry issue explain <issue-id>`
 
 Analyze an issue's root cause using Seer AI
 
@@ -228,7 +251,7 @@ sentry issue explain G --org my-org --project my-project
 sentry issue explain 123456789 --force
 ```
 
-#### `sentry issue plan <arg0>`
+#### `sentry issue plan <issue-id>`
 
 Generate a solution plan using Seer AI
 
@@ -253,7 +276,7 @@ sentry issue plan 123456789 --cause 0
 sentry issue plan MYPROJECT-ABC --org my-org --cause 1
 ```
 
-#### `sentry issue view <arg0>`
+#### `sentry issue view <issue-id>`
 
 View details of a specific issue
 
@@ -282,7 +305,7 @@ sentry issue view FRONT-ABC -w
 
 View Sentry events
 
-#### `sentry event view <arg0>`
+#### `sentry event view <event-id>`
 
 View details of a specific event
 

src/commands/event/view.ts

@@ -72,6 +72,7 @@ export const viewCommand = buildCommand({
       kind: "tuple",
       parameters: [
         {
+          placeholder: "event-id",
           brief:
             "Event ID (hexadecimal, e.g., 9999aaaaca8b46d797c23c6077c6ff01)",
           parse: String,