🦞 Moltbot

Built at the Zed x TRMNL Hackathon — Berlin, January 2026

A real-time agent monitoring dashboard for TRMNL e-ink displays. Track your AI agents' status, health, and performance at a glance.

---

🎯 Problem Solved

What if you could see the status of all your AI agents just by glancing at your desk?

Managing multiple AI agents across different platforms is chaos. You're constantly:

• Switching between terminals and dashboards
• Missing stuck or erroring agents
• Interrupting your flow to check on background tasks
• Losing track of token usage and context windows

Moltbot puts all of this on an always-visible e-ink display. No tabs. No notifications. Just glance up and know exactly what's happening.

What It Does

Feature	Description
🟢 Status at a glance	See running, stuck, done, and error states instantly
📊 KPI dashboard	Quick counts for all agent states
⏱ Uptime tracking	Monitor gateway uptime
🤖 Session details	Model, tokens, context %, last update
🖥 E-ink optimized	Crisp, readable design for TRMNL displays

---

🛠 Tech Stack

Category	Technology
Editor	Zed
AI Assistant	GitHub Copilot
LLM Provider	OpenRouter
Display Platform	TRMNL
Templating	Liquid
Styling	Custom CSS (E-ink optimized)
Frontend	HTML5, CSS3

---

🚀 How to Run

Prerequisites

• A TRMNL device
• TRMNL account with Private Plugin access

Quick Start

1. Log in to TRMNL Dashboard

   https://usetrmnl.com/dashboard
   

2. Create a Private Plugin

   • Go to Plugins → Private Plugin → Create New

3. Add Your Variables

   Variable	Type	Example
   sessions	Array	See below
   running_count	Number	0
   total_sessions	Number	4
   gateway_uptime	String	"1h 0m"

4. Paste the Markup

   • Copy markup.html into the plugin editor
   • Select Full layout

5. Save & Deploy — Your TRMNL updates on the next refresh!

Session Data Format

{
  "sessions": [
    {
      "model": "claude-haiku-4-5",
      "state": "error",
      "contact": "agent-beta",
      "last_update": "8h ago",
      "state_emoji": "🔴",
      "tokens_total": "13.8K",
      "context_percent": 7
    },
    {
      "model": "claude-haiku-4-5",
      "state": "stuck",
      "contact": "Console",
      "last_update": "26m ago",
      "state_emoji": "🟡",
      "tokens_total": "14.7K",
      "context_percent": 7
    }
  ],
  "running_count": 0,
  "total_sessions": 4,
  "gateway_uptime": "1h 0m"
}

State Types

State	Emoji	Color	Description
running	🟢	Green	Agent actively processing
done	🟢	Green	Agent completed successfully
stuck	🟡	Yellow	Agent needs attention
error	🔴	Red	Agent encountered an error

---

📁 Project Structure

moltbot/
├── README.md           # You are here
├── markup.html         # TRMNL plugin markup + styles
└── assets/
    └── preview.png     # Dashboard preview

---

🏆 Hackathon Context

This project was built in 3 hours at the Zed x TRMNL Hackathon in Berlin.

Challenge: Build the information display you actually want to see

Our approach: We wanted to solve a real problem we face daily — keeping track of multiple AI agents running in the background while coding. Instead of context-switching to check terminals, we built a passive display that shows everything at a glance.

---

👥 Team

Built with ☕ and 🦞 by:

Name	Role
Emre	Developer
Mohamed	Developer
Palani	Developer
Arian	Developer

---

🔗 Resources

• TRMNL Docs
• TRMNL Design Framework
• Zed Editor
• OpenRouter API
• TRMNL Creator Fund

---

📄 License

MIT License — use it, fork it, make it yours.

---

🦞 Moltbot

Because your agents deserve a beautiful dashboard

Built at Zed x TRMNL Hackathon · Berlin · January 2026