Simplify top-level help for human users

Open
#1,583 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
68/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
cli

Research direction

Locate the CLI entry point that renders default help and inspect the existing agent-detection behavior. Update the human-oriented overview to omit inline subcommand lists while preserving the expanded agent output, then verify both modes and that sentry help <command> still exposes subcommands.

Written by the indexing model from the issue text.

Description

Reported by Vjeran Grozdanic.

Running sentry without arguments feels overwhelming on first use. The output lists command groups alongside all their subcommands, such as auth login | logout | refresh | status | token | whoami, making the overview difficult to scan.

  • For human users, show top-level commands without inline subcommand lists; subcommands remain discoverable with sentry help <command>.
  • Preserve the expanded output for agents, using the CLI’s existing agent-detection behavior so they can discover capabilities with fewer calls.

Related: #81 introduced the broader default-help redesign; this is a narrower follow-up about information density.

via bete.

--

View Junior Session [Sentry]

Dominant language
TypeScript
Stars
121
Forks
14
Avg merge
22h 3m
Merged PRs (30d)
94

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from getsentry/cli

All issues in getsentry/cli

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.