trmy (pronounced "Termy") is a chat-based assistant built into your TRMNL dashboard. You can ask it about your devices, playlists and plugins in whatever language you prefer.
trmy answers questions with live cards like battery and Wi-Fi, what a screen is showing right now, or what's next in a playlist. It can make changes too, and it always asks for your permission first.
Prerequisites
a TRMNL device on your account, for the free daily messages
or AI credit, to use trmy without a device or past the free messages
Step 1 - Open trmy
Click the trmy icon at the far right end of the bottom navigation. Your dashboard turns into the trmy home view: cards on top, a message box below, and chats on the left. Click the face again to go back to the classic dashboard.
Until you pin your own cards, the home shows two to start with: every device on your account, and the playlist of the device you have selected.
Above the cards, trmy points out what needs you now: a battery below 15%, a plugin that stopped with an error, a device that has not checked in for 3 days, or an empty playlist. Click one to fix it, or click the X to dismiss it. A dismissed notice comes back after a week if the problem is still there.
Step 2 - Ask something
Type in the message box and press Enter. Shift+Enter adds a new line. Or click one of the 1-click questions under the cards, like "Which device has the lowest battery?" or "Show me what my TRMNL shows now". Some of these may suggest a plugin or recipe you might want to install, based on what you already use.
Chat replies can carry cards. Here are a few things to ask, and what comes back:
"how's the Bedroom device doing?" A device card with battery, Wi-Fi and last check-in, plus a short read of what looks wrong.
"show me what the Kitchen TRMNL shows now" The image on that screen, and when it was shown.
"what's on my playlist right now?" The playlist in order, with the screen that shows now marked.
"why is Shop Sales blank?" When the plugin last refreshed, any error, and its latest logs. trmy reads the logs too, and tells you what it finds.
"show errors from my Weather and Stocks plugins" One logs card for up to 5 plugins, filtered to the levels you ask for.
"how much have I spent on trmy this month?" A chart of one of your numbers, day by day.
"add Hacker News to the Bedroom playlist" A change, shown for you to confirm first.
Step 3 - Confirm changes
trmy can change your account: rename a device, slow its refresh rate, add or remove playlist items, install a plugin and edit its settings.
Before any change runs, it shows a card with what it will do and, where it applies, the value before and after. Nothing changes until you click Confirm. Click Cancel and trmy hears that too.
Some actions only show a button. To connect a plugin that signs in to another service, such as Google Calendar or Todoist, trmy shows a Connect button. You sign in on that service's own page and land back in the same chat, where trmy picks up from there.
When a plugin needs a password or an API key, trmy asks with a private form instead. The AI never sees what you type there. Never paste a secret into the message box: trmy refuses a message that looks like one.
For a private plugin, trmy shows a button that opens the plugin editor, where the plugin's own agent builds the screens with your request already filled in.
Step 4 - Pin cards to your home
Under most cards in a chat there is a Pin to home button. Click it and the card joins your home. You can also ask: "pin it to my home" works.
A pinned card keeps only what it points at, such as a device or a plugin, not a copy of the data. So the home is current every time you open it.
Buttons and forms, such as Confirm, Connect or a private form, do the job once and cannot be pinned.
To add a card without a chat, click Add a card on the home. The gallery shows every card your account can hold, filled with your own data. Choose a device, plugin or number where it asks, then click Pin to home.
Available cards you can pin to your home view:
Device: battery, Wi-Fi and last check-in of one device.
Devices: every device, with battery and last check-in.
Playlist: what a device shows, in order.
Screen: the screen a device shows now.
Plugin: when a plugin last refreshed, and any error.
Logs: the latest logs of up to 5 plugins, optionally only errors or warnings. Ask for this one in a chat.
Chart: plugin installs, AI agent tokens, AI agent spend or plugin errors, day by day. The gallery shows 30 days; in a chat you can ask for 7 to 90.
Your published plugins: installs and growth, if you publish plugins or recipes.
The home view holds up to 12 cards.
Step 5 - Arrange your home
Click Edit at the top of the home. Each card gets a handle in its top left corner and an X in its top right.
Drag a card by its handle to move it. With a keyboard, focus the handle and use the arrow keys.
Click the X to remove a card. This removes it from the home only; your device or plugin is not touched.
Click Done when the order looks right. Each move saves as you make it.
Step 6 - Rename and archive chats
trmy names each chat from your first message. To change it, hover the chat in the list on the left, click the three dots, then Rename. Type the new name and press Enter, or Esc to keep the old one. A name holds up to 60 characters. The same menu sits at the top right of an open chat.
Archive takes a chat out of the list. Archived chats sit in a fold at the bottom of the list. Open one and click Unarchive in the same menu to bring it back. When you tell trmy you're done, it also offers to archive the chat or start a new one.
Step 7 - You're done!
Your home now opens on the cards you care about, current every time.
Privacy
trmy runs through OpenRouter. TRMNL routes your messages only to AI providers that keep no copy of them (zero data retention) and never train on them.
trmy reads what you type in the message box, and the account data it needs to answer, such as your devices, playlists and plugin logs. It never sees what you type into a private form, such as a password or an API key.
Troubleshooting
I don't see the trmy face in the bottom menu.
trmy mode is not on for every account yet. When it reaches yours, the face shows up there, with nothing to turn on. To get access today, email support@trmnl.com with subject "enable trmy on my account."
"You've used today's free trmy messages."
The free messages come back over the next 24 hours, and the message says roughly when. Add AI credit to keep going now. Free messages need a TRMNL device on your account; a trial device does not count.
"Free trmy messages are used up for everyone today."
There is a daily total across all accounts as well. Same fix: wait a few hours, or add AI credit.
"This looks like an API key. Never paste secrets here."
trmy found something in your message that looks like a password, key or token, and did not send it. Ask trmy to set up the plugin instead, and it gives you a private form for the secret.
"Please wait for the current reply to finish."
trmy writes one reply at a time per account, across all your chats. Wait for the current one, then send again.
"This chat is long now."
Start a new chat. A long chat makes every reply slower and uses more of your messages.
"trmy stopped this reply after too many steps."
The request needed more steps than one reply allows. Split it into smaller asks, such as one device or one playlist at a time.
A card says "This card has nothing to show right now".
What it points at has no data yet, for example a device that has not shown a screen, or a plugin with no logs. It fills in on its own once there is data.
The plugin errors chart stops at 14 days.
Plugin logs are kept for 14 days, so that chart cannot go back further.
I can't pin another card.
The home holds 12 cards. Click Edit and remove one first.
Connecting a plugin says "Not connected."
The sign-in on the other service was cancelled or failed. Ask trmy to try again, and it shows a new Connect button.








