/hq-whoami — HQ Cognito identity

SkillDev tools

Show current HQ Cognito identity and session expiry.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the /hq-whoami — HQ Cognito identity skill

What this skill tells your AI

The instructions your AI receives, as published by indigoai-us/hq-core in .claude/skills/hq-whoami/SKILL.md and read by ahel’s review.

One-liner status: who is signed into the local HQ Cognito session, and how long the cached access token has left. Read-only — touches nothing.

Steps

  1. Probetest -f ~/.hq/cognito-tokens.json. If absent, print "Not signed in. Run /hq-login." and exit 0.

  2. Statushq auth status for cached identity + expiry. If the CLI reports expired, hint that /hq-login will silently refresh.

  3. Identityhq whoami for canonical sub/email (Cognito userInfo).

  4. Format — collapse to one line: signed in as <email> (sub <id-prefix>…) — expires in <Xh Ym>. If expired: signed in as <email> — token EXPIRED, run /hq-login.

Notes

  • Reads ~/.hq/cognito-tokens.json only — same file as /deploy, /hq-login, /hq-logout.
  • Pool: shared HQ Identity.
  • Does not refresh the token; for that, run /hq-login (it auto-refreshes if expired).

See also

  • /hq-login — sign in or refresh
  • /hq-logout — sign out

Signals

GitHub stars
84
Forks
15
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
hq-whoami
Source
github.com/indigoai-us/hq-core