macOS + AWS SSO

Never hit "token expired" again

A tiny daemon that automatically refreshes your AWS SSO sessions before they expire.

$ brew install jhubbardsf/aws-sso-refresh/aws-sso-refresh

Before

Your AWS SSO tokens expire every few hours. You're deep in work, run a command, and... "The SSO session has expired". Context switch. Browser. Click. Wait. Back to work.

After

Install the daemon once. It checks every 10 minutes and refreshes sessions before they expire. Your tokens stay fresh. You stay focused.

$ aws-sso-refresh status

AWS SSO Sessions:

  ✓ my-company-sso     5h 23m remaining
  ✓ my-personal-sso    2h 10m remaining

Daemon: running (PID 1234)
Interval: every 10 minutes
Threshold: refresh when < 30m remaining

Simple by design

⚙

Zero config

Reads your existing ~/.aws/config. If you have SSO sessions, it just works.

🔌

Runs quietly

Uses macOS launchd to check every 10 minutes. Opens browser only when needed.

📦

One command

Install with Homebrew. Run aws-sso-refresh install. Done.

Get started in 30 seconds

View on GitHub Read the docs