Hevy Bot

Today

  • Followed—
  • Unfollowed—
  • Liked back—

Last 7 days

  • Followed—
  • Unfollowed—
  • Liked back—
  • Follow-back rate—

All time

  • Total followed—
  • Total unfollowed—
  • Total liked back—
  • Currently following—

Per-tier conversion (last 30 days)

TierAttemptedReciprocatedActiveRate

Higher rate = better source. Use this to tune tier_weights in settings.

Last run

—

Edit, click Copy JSON, then Open editor to paste it into GitHub. We can't write directly without a PAT.

Identity
Feature flags
Caps (per run)
Unfollow rules
Pre-flight filter
Whitelist (one username per line — never unfollowed)
Niche prefixes (rotated, one per line)
Tier weights

Currently informational — the runner consumes tiers in priority order regardless of weight. Weights will be wired into ranked candidate selection in a later iteration.

Open editor on GitHub →
Generated JSON 

      

    


    
    

      
One-time setup per account

      
    
        
  1. 
          Capture a refresh token from your Hevy session.
          
      
            
    • Open hevy.com and log in.
      • 
            
    • Open DevTools → Application → Cookies → select hevy.com.
      • 
            
    • Copy the value of auth2.0-token (it's ~210 chars).
      • 
          
    
        
    2. 
        
  2. 
          Add it as a GitHub Actions secret.
          
      
            
    • In this repo: Settings → Secrets and variables → Actions → New repository secret.
      • 
            
    • Name: HEVY_REFRESH_ (e.g. HEVY_REFRESH_TIM).
      • 
            
    • Value: the cookie you copied.
      • 
          
    
        
    3. 
        
  3. 
          Edit your settings.json.
          Set hevy_username, set enabled: true, tune caps. Save via the Settings tab here.
        
    4. 
        
  4. 
          Verify the token.
          Actions tab → Check Hevy Token workflow → Run workflow → enter your account name. A green check means the secret is valid.
        
    5. 
        
  5. 
          Let it run.
          The bot runs daily at 05:00 UTC. You can also trigger it manually via the Hevy Bot workflow.
        
    6. 
      


      
Adding a new account

      
    
        
  1. Create accounts/<name>/settings.json (copy accounts/brother/settings.json as a template).
    2. 
        
  2. Add the secret HEVY_REFRESH_<NAME>.
    3. 
        
  3. Add <name> to the matrix in .github/workflows/run-bot.yml.
    4. 
        
  4. Add <name> to ACCOUNTS in docs/app.js.
    5. 
      


      
Reading state from a private repo

      

        If your repo is private, this dashboard needs a fine-grained read-only PAT
        (Contents:Read on this repo only). Paste it below — it stays in this browser's localStorage.