/hq-logout — HQ Cognito sign-out (local)

SkillDev tools

Sign out of HQ Cognito and clear local tokens.

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-logout — HQ Cognito sign-out (local) skill

What this skill tells your AI

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

Removes the cached Cognito session at ~/.hq/cognito-tokens.json so future HQ-authenticated operations (deploy, vault, sync) require a fresh sign-in.

Local only. Refresh tokens remain valid server-side until they expire naturally — they just can't be used without ~/.hq/cognito-tokens.json. If you need to revoke at the pool, ask for AWS Cognito GlobalSignOut explicitly (not in scope here).

Steps

  1. Probetest -f ~/.hq/cognito-tokens.json. If absent, report "already signed out" and exit.

  2. Clearhq auth logout (delegates to @indigoai-us/hq-cli's logout subcommand, which removes the token file).

  3. Confirmtest ! -f ~/.hq/cognito-tokens.json and report success.

Notes

  • Same file consumed by /deploy — after this, /hq-login (or any deploy) will trigger a fresh browser flow.
  • Does NOT touch ~/.hq-deploy/config.json (that's the unrelated hq-deploy CLI's API-key store, not currently used here).

Signals

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