feat(team): add team list command (#238)

## Summary

Adds a `sentry team list` command to list teams in an organization,
along with a `sentry teams` shortcut alias. Follows the same patterns as
`repo list` — optional positional org arg, config defaults, DSN
auto-detection fallback.

## Changes

New command at `src/commands/team/list.ts` with human-readable table
output (ORG, SLUG, NAME, MEMBERS columns) and `--json` support.
Registered in the app route map with a `teams` top-level shortcut.
Includes 8 unit tests covering JSON output, empty states, limit
overflow, and all org resolution paths (explicit, default, DSN
detection, all-orgs fallback).

## Test Plan

```bash
bun test test/commands/team/list.test.ts   # 8 tests pass
bun run typecheck                          # clean
bun run lint                               # clean
```

Author: betegon

docs/src/content/docs/commands/index.md

@@ -13,6 +13,7 @@ The Sentry CLI provides commands for interacting with various Sentry resources.
 | [`cli`](./cli/) | CLI-related commands (feedback, upgrade) |
 | [`org`](./org/) | Organization operations |
 | [`project`](./project/) | Project operations |
+| [`team`](./team/) | Team operations |
 | [`issue`](./issue/) | Issue tracking |
 | [`event`](./event/) | Event inspection |
 | [`log`](./log/) | Log viewing and streaming |

docs/src/content/docs/commands/team.md

@@ -0,0 +1,62 @@
+---
+title: team
+description: Team commands for the Sentry CLI
+---
+
+Manage Sentry teams.
+
+## Commands
+
+### `sentry team list`
+
+List teams in an organization.
+
+```bash
+# Auto-detect organization or list all
+sentry team list
+
+# List teams in a specific organization
+sentry team list <org-slug>
+
+# Limit results
+sentry team list --limit 10
+```
+
+**Arguments:**
+
+| Argument | Description |
+|----------|-------------|
+| `[org-slug]` | Optional organization slug to filter by |
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| `-n, --limit <number>` | Maximum number of teams to list (default: 30) |
+| `--json` | Output as JSON |
+
+**Example output:**
+
+```
+ORG         SLUG        NAME              MEMBERS
+my-org      backend     Backend Team            8
+my-org      frontend    Frontend Team           5
+my-org      mobile      Mobile Team             3
+```
+
+**JSON output:**
+
+```bash
+sentry team list --json
+```
+
+```json
+[
+  {
+    "id": "100",
+    "slug": "backend",
+    "name": "Backend Team",
+    "memberCount": 8
+  }
+]
+```

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

@@ -440,6 +440,33 @@ List repositories
 - `-n, --limit <value> - Maximum number of repositories to list - (default: "30")`
 - `--json - Output JSON`
 
+### Team
+
+Work with Sentry teams
+
+#### `sentry team list <org>`
+
+List teams
+
+**Flags:**
+- `-n, --limit <value> - Maximum number of teams to list - (default: "30")`
+- `--json - Output JSON`
+
+**Examples:**
+
+```bash
+# Auto-detect organization or list all
+sentry team list
+
+# List teams in a specific organization
+sentry team list <org-slug>
+
+# Limit results
+sentry team list --limit 10
+
+sentry team list --json
+```
+
 ### Log
 
 View Sentry logs
@@ -594,6 +621,18 @@ List repositories
 - `-n, --limit <value> - Maximum number of repositories to list - (default: "30")`
 - `--json - Output JSON`
 
+### Teams
+
+List teams
+
+#### `sentry teams <org>`
+
+List teams
+
+**Flags:**
+- `-n, --limit <value> - Maximum number of teams to list - (default: "30")`
+- `--json - Output JSON`
+
 ### Logs
 
 List logs from a project

src/app.ts

@@ -21,6 +21,8 @@ import { projectRoute } from "./commands/project/index.js";
 import { listCommand as projectListCommand } from "./commands/project/list.js";
 import { repoRoute } from "./commands/repo/index.js";
 import { listCommand as repoListCommand } from "./commands/repo/list.js";
+import { teamRoute } from "./commands/team/index.js";
+import { listCommand as teamListCommand } from "./commands/team/list.js";
 import { traceRoute } from "./commands/trace/index.js";
 import { listCommand as traceListCommand } from "./commands/trace/list.js";
 import { CLI_VERSION } from "./lib/constants.js";
@@ -36,6 +38,7 @@ export const routes = buildRouteMap({
     org: orgRoute,
     project: projectRoute,
     repo: repoRoute,
+    team: teamRoute,
     issue: issueRoute,
     event: eventRoute,
     log: logRoute,
@@ -45,6 +48,7 @@ export const routes = buildRouteMap({
     orgs: orgListCommand,
     projects: projectListCommand,
     repos: repoListCommand,
+    teams: teamListCommand,
     logs: logListCommand,
     traces: traceListCommand,
   },

src/commands/team/index.ts

@@ -0,0 +1,13 @@
+import { buildRouteMap } from "@stricli/core";
+import { listCommand } from "./list.js";
+
+export const teamRoute = buildRouteMap({
+  routes: {
+    list: listCommand,
+  },
+  docs: {
+    brief: "Work with Sentry teams",
+    fullDescription: "List and manage teams in your Sentry organizations.",
+    hideRoute: {},
+  },
+});