Successfully parsed game results: When you send a game result we recognize, we'll mark your message as read. No other response is sent to keep your chat clean.

Messages we don't understand: If we don't recognize your message as a game result, we leave it unread. This helps you see which messages need attention.

Commands and errors: When you send a command like help, we'll send you a text reply with information.

• Airportle
• Airportle Club
• Blossom preview
• Bracket City preview
• Clues by Sam
• Conexo preview
• Connections
• Connections: Sports Edition
  • Losses are not recorded because the NYT share text omits the puzzle number on unsuccessful games (as of April 2026). If the NYT adds puzzle numbers to losses, they will be picked up automatically.
• Flashback
• Gisnep
• Letroso preview
• Murdle preview
• NYT Daily Crossword
• NYT Midi Crossword
• NYT Mini Crossword
• Pips Easy
• Pips Hard
• Pips Medium
• Reunion preview
• Reunion Extreme preview
• Squeezy preview
• Strands
• Tightrope preview
• Twofer Goofer preview
• Waffle preview
• Waffle Deluxe preview
• Wordle

Games marked preview are in early testing. To opt in, send preview games on to the bot. Your results will be tracked and appear on your stats page. Send preview games off to opt out — your data is preserved and will reappear if you re-enable.

Don't see your game? Send it anyway — we may add it.

Send it anyway. We store all messages for up to 120 days. If we add support for your game during that window, we'll go back and pick up your past results automatically — no need to re-send anything.

Sending unsupported games also helps us prioritize. When we see that people are actually playing a game, it moves up the list. The bot won't respond to messages it doesn't recognize (it leaves them unread), but they're not lost.

Your personal stats page has a unique link that was sent to you when you first used the bot. Visit it anytime — no login needed.

See a sample stats page to get an idea of what's tracked.

Important: Keep your stats link private — anyone with it can view your game history. If you lose access to your Signal account, you may not be able to recover your stats.

Message the bot on Signal (or search for @puzzlesecretary.01) and send a game result. The bot will create your account automatically and reply with a link to your personal stats page. No signup needed.

We store:

• Your Signal account identifier
• Game results you send
• Messages you send, for up to 120 days

For full details, see our Privacy & Terms.

Data deletion features are planned for a future release. For now, email [email protected] to request deletion.

Yes! You can link multiple Signal numbers to a single account. All your games will count toward the same stats.

How to link accounts:

1. From your primary account, send link
2. The bot will reply with a one-time code (e.g., link word-word-word)
3. From your other account, send that exact message
4. Your accounts are now linked! All games count toward the same stats.

Important:

• Link codes expire after 24 hours
• You can link as many accounts as you want

To unlink a number: Send unlink from that number and follow the confirmation prompt. Your games stay with your account - only the account you send the unlink command from is removed.

The bot only responds with text to commands (like help) or errors. For game results we recognize, we only mark the message as read to keep your chat clean.

If your message was left unread, the bot didn't recognize it as a supported game format. Try:

• Sending the complete game result (copy/paste from the game)
• Checking that it's a supported game
• Sending help to verify the bot is working

Even if the bot doesn't recognize your game today, keep sending it — we store messages for up to 120 days and can pick up results retroactively when we add new games.

Group leaderboards let you compete with friends and family on the same games.

Creating a group:

1. Send group create to the bot
2. Follow the link to name your group and choose your display name
3. Share the invite code with people you want to join

Joining a group:

1. Get the 3-word invite code from the group owner
2. Send join word-word-word to the bot
3. Follow the link to choose your display name

Managing groups: Send groups to see all your groups and get management links. Owners can regenerate invite codes and remove members. Members can change their display name or leave the group.

Privacy: Group leaderboards are private and only accessible via the unique URL. Members see each other's display names and game results, but not phone numbers or personal stats URLs.

Each game has its own ranking criteria. When two players submit the same game, we compare their results using game-specific rules:

• Airportle: Fewer guesses wins. Ties broken by: more greens, more yellows, row-by-row green comparison, then earlier submission if over 48 hours apart.
• Airportle Club: Fewer guesses wins. Ties broken by: more greens, more yellows, row-by-row green comparison, then earlier submission if over 48 hours apart.
• Blossom preview: Highest score wins. Longer longest word breaks ties. Ties broken by earlier submission if over 48 hours apart.
• Bracket City preview: Highest score wins. Hard mode beats normal mode at the same score. Fewer mistakes or keystrokes break ties. Ties broken by earlier submission if over 48 hours apart.
• Clues by Sam: Fewest double hints wins, then fewest single hints, fewest yellow (mistakes), most green (correct), then fastest time. If still tied, earlier submission wins if over 48 hours apart.
• Conexo preview: Fewest guesses wins. Fewer hints and mistakes break ties. Ties broken by earlier submission if over 48 hours apart.
• Connections: Fewest mistakes wins. Losses ranked by categories completed. Ties broken by earlier submission if over 48 hours apart.
• Connections: Sports Edition: Fewest mistakes wins. Losses ranked by categories completed. Ties broken by earlier submission if over 48 hours apart.
• Flashback: Highest score wins. Fewer red squares break ties. Ties broken by earlier submission if over 48 hours apart.
• Gisnep: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
• Letroso preview: Fewest guesses wins. More correct positions break ties. Ties broken by earlier submission if over 48 hours apart.
• Murdle preview: More correct clues wins. Faster time breaks ties. Ties broken by earlier submission if over 48 hours apart.
• NYT Daily Crossword: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
• NYT Midi Crossword: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
• NYT Mini Crossword: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
• Pips Easy: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
• Pips Hard: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
• Pips Medium: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
• Reunion preview: Fewest moves wins. More stars break ties. Ties broken by earlier submission if over 48 hours apart.
• Reunion Extreme preview: Fewest moves wins. More stars break ties. Ties broken by earlier submission if over 48 hours apart.
• Squeezy preview: Fewest guesses and reveals wins. Reveals are worse than guesses. Wheezy beats Breezy at same count. Ties broken by fewer LS, then PZ, then EZ guesses.
• Strands: Fewest hints wins. Ties broken by earlier spangram position in the grid, then earlier submission if over 48 hours apart.
• Tightrope preview: Highest score wins. More correct answers and fewer wrong answers break ties. Ties broken by earlier submission if over 48 hours apart.
• Twofer Goofer preview: Solved beats unsolved. Fewer hints wins. Faster time breaks ties. Ties broken by earlier submission if over 48 hours apart.
• Waffle preview: Solved beats unsolved. More stars beats fewer. More 🟩 beats fewer. Ties broken by earlier submission if over 48 hours apart.
• Waffle Deluxe preview: Solved beats unsolved. More stars beats fewer. More 🟩 beats fewer. Ties broken by earlier submission if over 48 hours apart.
• Wordle: Fewer guesses wins. Ties broken by: hard mode bonus, more greens, more yellows, row-by-row green comparison, then earlier submission if over 48 hours apart.

Why the 48-hour tiebreaker?

You may have noticed that many games use "earlier submission wins if over 48 hours apart" as a final tiebreaker. This exists because the system does not assign games to a specific day, even when the games themselves are dated.

Many games reset at midnight local time, so a puzzle dated "January 5th" might be submitted on the 5th by someone in one time zone and the 6th by someone in another timezone, relative to the first person. We cannot reliably tell whether a late submission is a backfill (someone catching up on a missed day) or a timely submission from a different time zone.

The 48-hour window handles this gracefully: submissions within 48 hours of each other are treated as equivalent for tiebreaking purposes. Only when submissions are more than 48 hours apart does the earlier one win — at that point it is very likely that the later submission is a backfill rather than a same-day play.

No. The bot reads game results with straightforward code and stores your stats in a traditional database. No AI, machine learning, or LLMs are involved.