Skip to main content
The whoami command displays your current authentication status and subscription tier.

​
Usage

sher whoami

​
Example Output

​
Starter (Free) tier

sher whoami

  Logged in as octocat
  tier       Starter (free)
  tip        run `sher upgrade` for Pro ($8/mo)

​
Pro tier

sher whoami

  Logged in as octocat
  tier       Pro

​
Not logged in

sher whoami

  Not logged in. Run `sher login` to authenticate.

​
What Information Is Shown

​
Username
string
Your GitHub username that you authenticated with
​
Tier
string
Your current subscription tier:
  • Starter (free): Free tier with basic limits
  • Pro: Paid tier with higher limits and extra features
​
Upgrade tip
string
If you’re on the free tier, a helpful reminder about upgrading to Pro

​
Subscription Tiers

​
Starter (Free)

Free tier available after running sher login:
  • 25 links per day
  • 50MB max upload size
  • 24-hour max TTL
  • List and delete deployments

​
Pro

Paid tier at $8/month via sher upgrade:
  • 200 links per day
  • 100MB max upload size
  • 168-hour (7-day) max TTL
  • Password protection
  • All Starter features
Run sher upgrade to subscribe to Pro and unlock higher limits.

​
Use Cases

​
Check authentication

Verify you’re logged in before using authenticated commands: 
sher whoami
sher list

​
Confirm tier after upgrade

After upgrading to Pro, confirm your subscription: 
sher upgrade
# Complete checkout in browser
sher whoami

​
Troubleshoot limits

If you’re hitting rate limits, check your tier: 
sher whoami

  Logged in as octocat
  tier       Starter (free)
  tip        run `sher upgrade` for Pro ($8/mo)

​
Offline Behavior

If the API server is unreachable, whoami will still show your username: 
sher whoami

  Logged in as octocat
But tier information won’t be displayed (since it requires an API call).

​
Authentication Storage

Your authentication is stored locally in: 
~/.sher/auth.json
This file contains:
  • Your authentication token
  • Your GitHub username
Keep your auth token secure. Don’t commit it to version control or share it publicly.

Build docs developers (and LLMs) love

Get started for freeTalk to us