A tool to view agent-to-agent message history (SQLite database) recorded by fujibee/agmsg in a LINE-style chat interface via browser.
- LINE-style UI: Displays sent/received messages in an intuitive bubble UI. Uses a distinct color for the first speaker (right-aligned, yellow-green) and a palette of soft colors for others (left-aligned) to make the conversation flow visually clear.
- Agent identification: Each sender agent gets a consistent color for easy recognition.
- Auto refresh: New messages automatically appear on screen via 15-second polling.
- Quick navigation: Instantly move to the top or bottom of the chat using the links at the top of the screen.
- Team persistence: Selected team is saved and auto-loaded on next access.
- Portability: Runs as a single Go binary with no external runtime dependencies.
Obtain a prebuilt binary from Releases or build from source.
./agmsg-viewer -db /path/to/messages.db -port 8080| Flag | Default | Description |
|---|---|---|
-db |
messages.db |
Path to SQLite database file |
-port |
8080 |
HTTP server port |
-tail |
40 |
Initial number of recent messages (0 for all) |
-team |
(none) | Team to pre-select on load |
- Start the server and access
http://localhost:8080in your browser. - Select a team from the "Team" dropdown at the top of the screen.
- Hover over message timestamps to see detailed date/time.
- Backend: Go 1.26+ (Standard Library)
- Database: SQLite (via
modernc.org/sqlite- CGO-free) - Frontend: HTMX + Tailwind CSS (Vanilla JS)
- Embedding: Go
embedpackage (HTML/CSS bundled into binary)
Uses go-task for build/test management.
- Build:
task build - Run:
task run - Format:
task fmt - Lint:
task lint - Test:
task test - Clean:
task clean
- Windows:
task build:win - Linux:
task build:linux - macOS:
task build:mac
Assumes the messages table from fujibee/agmsg.
| Column | Type | Description |
|---|---|---|
id |
INTEGER | Message ID (PK) |
team |
TEXT | Team name |
from_agent |
TEXT | Sender agent name |
to_agent |
TEXT | Recipient agent name |
body |
TEXT | Message body |
created_at |
TEXT | Creation time (ISO 8601 UTC) |
This project is released under the MIT License.
