PS Companion and Trophy Aid

PS Companion is a desktop PlayStation companion app built with Electron. It uses psn-api to authenticate with PSN, pull profile and presence data, load trophy titles and earned trophies, surface play activity, and show friends and devices in one local dashboard.

The most interesting part is Trophy Aid. Instead of giving generic guide text, it stays scoped to one selected game, reads your current trophy progress, can pull in extra per-game .md or .json notes, stores conversation history on disk, and sends that context through a provider layer for GitHub Copilot, OpenAI, Anthropic, Gemini, or OpenRouter. The reply is not just plain text either: the backend returns structured trophy and progress tokens, and the chat UI turns those into interactive components.

Trophy Aid is strongest when it shows state directly in the conversation. The [[progress:overall]] token becomes a progress card, and [[trophy:TROPHY_ID|TROPHY_NAME]] references become trophy chips with hover and focus tooltips, so the answer can point at a cleanup route without making you leave the chat.

Trophy Aid Showcase

The example content below uses real ASTRO's PLAYROOM trophy names, descriptions, and a few real trophy icons so the UI reads like an actual Trophy Aid conversation instead of a generic mockup.

ASTRO's PLAYROOM

New chat

03/18/2026 19:42:13 New chat

Current Progress

Overall Progress 29/45 (64%)

17/26 8/13

4/5

0/1

Best next step: finish the easy cleanup first, then move into the trickier Cooling Springs and CPU Plaza trophies before doing a final missable sweep.

You Got a Trophy! Jumping Splash! Keepy Uppies Hidden Trophy

The backend contract is what makes this work: `[[progress:overall]]` turns into the card above, and each `[[trophy:...]]` token becomes a chip with a hoverable trophy card instead of dead text.

7:42 PM

Checking your progress

Reading your trophies and guide context for ASTRO's PLAYROOM .

Should I clear easy bronzes first or go straight for the harder Cooling Springs cleanup?

GitHub Copilot

gpt-4.1 o4-mini

Enter to send | Shift+Enter for new line

The nice detail here is that the UI is tied back to the backend contract. The service layer already emits trophy references and overall progress markers, and the renderer hydrates those into chips, tooltips, and progress widgets that are useful even before you open the full trophy detail page. That makes Trophy Aid feel like a real part of the app, not just an AI tab bolted onto it.