Skip to content

Dashboard

The Dashboard (/dashboard) is what Snippbot opens to. It answers one question — what am I working on? — with a compact stat strip on top and everything you have favorited below it, grouped by kind.

Visiting / redirects here.

Anything you star anywhere in the UI shows up on the Dashboard. Five kinds can be favorited today:

KindWhere you star it
ChatsThe star on a row in the chat history sidebar, or Add to Dashboard in a chat tab’s right-click menu
ProjectsThe star in a project card’s action row
PackagesThe star on a package row or card, on the Packages page
AssetsAdd to Dashboard in an asset’s right-click menu
Scheduled jobsThe star in a job card’s action row, on the Schedule page

Favorites live in the daemon, not in your browser, so they follow you to the Snippbot mobile app and to any other browser pointed at the same install. Starring something on your desktop updates the star everywhere within a second — the daemon pushes a favorite.added / favorite.removed event over its WebSocket bus.

Drag a card within its section to reorder it. The order is saved per section and persists across devices.

If you delete a project, chat or scheduled job — or uninstall a favorited package — its favorite disappears with it.

An entity that vanishes some other way (an asset removed while the daemon was stopped, say) leaves a dimmed card marked No longer available with a Remove button. That is deliberate: a favorite silently disappearing looks like data loss, so the Dashboard shows you what happened instead.

A section with nothing starred in it shows a rotating tip about that part of Snippbot, with arrows to step through the deck and a reminder of how to add something to it. Once a section has favorites, the tip collapses behind the lightbulb icon in its heading — click it any time to bring the deck back.

Collapsing a section, and hiding or showing its tips, is remembered per browser.

The header shows a condensed read of the same data the Monitoring UI presents in full:

StatMeaning
TokensTotal tokens consumed in the selected period
ConversationsConversations active in the period
Task successShare of attempted tasks that completed, with the failure count
Active jobsScheduled jobs currently active, with the paused count
SchedulerWhether the scheduler engine is running

The period selector defaults to Last 24h — the Dashboard is a “right now” view, where the Monitor page is for analysis and defaults to 7 days. Your choice is remembered per browser.

Favorites are ordinary REST resources, so scripts and other clients can use them:

Terminal window
# Everything you have starred, hydrated into render-ready cards
curl -H "Authorization: Bearer $SNIPPBOT_API_KEY" \
http://localhost:18781/api/favorites
# Star a project
curl -X POST -H "Authorization: Bearer $SNIPPBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"entity_type":"project","entity_id":"proj_abc123"}' \
http://localhost:18781/api/favorites
# Unstar it again
curl -X DELETE -H "Authorization: Bearer $SNIPPBOT_API_KEY" \
"http://localhost:18781/api/favorites?entity_type=project&entity_id=proj_abc123"

Starring is idempotent: repeating the POST returns the existing favorite rather than an error. entity_type must be one of conversation, project, package, asset, scheduled_job — anything else returns a 400 listing the valid types.