Arylmera
diff --git a/‎CHANGELOG.md‎
Lines changed: 9 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 9 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 6 additions & 0 deletions b/‎README.md‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎crates/token-dashboard-cli/Cargo.toml‎
Lines changed: 1 addition & 1 deletion b/‎crates/token-dashboard-cli/Cargo.toml‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎crates/token-dashboard-cli/openapi.json‎
Lines changed: 19 additions & 0 deletions b/‎crates/token-dashboard-cli/openapi.json‎
Lines changed: 19 additions & 0 deletions
diff --git a/‎crates/token-dashboard-cli/src/routes.rs‎
Lines changed: 30 additions & 6 deletions b/‎crates/token-dashboard-cli/src/routes.rs‎
Lines changed: 30 additions & 6 deletions
diff --git a/‎crates/token-dashboard-core/Cargo.toml‎
Lines changed: 1 addition & 1 deletion b/‎crates/token-dashboard-core/Cargo.toml‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎crates/token-dashboard-core/src/queries.rs‎
Lines changed: 45 additions & 0 deletions b/‎crates/token-dashboard-core/src/queries.rs‎
Lines changed: 45 additions & 0 deletions
diff --git a/‎crates/token-dashboard-core/tests/activity_heatmap.rs‎
Lines changed: 70 additions & 0 deletions b/‎crates/token-dashboard-core/tests/activity_heatmap.rs‎
Lines changed: 70 additions & 0 deletions
diff --git a/‎crates/token-dashboard-tauri/Cargo.toml‎
Lines changed: 1 addition & 1 deletion b/‎crates/token-dashboard-tauri/Cargo.toml‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎crates/token-dashboard-tauri/tauri.conf.json‎
Lines changed: 1 addition & 1 deletion b/‎crates/token-dashboard-tauri/tauri.conf.json‎
Lines changed: 1 addition & 1 deletion
@@ -10,6 +10,15 @@ human-curated highlights.
 
 ## [Unreleased]
 
+## [4.1.5] - 2026-05-24
+
+### Added
+- Three new special themes: Terminal, Cockpit, and Grimdark.
+- Dismiss button on tip cards.
+
+### Fixed
+- Activity heatmap now aggregates server-side over the full selected window.
+
 ## [4.1.4] - 2026-05-24
 
 ### Fixed
 
@@ -8,6 +8,12 @@
 [![License](https://img.shields.io/github/license/Arylmera/Token-Dashboard?style=for-the-badge)](LICENSE)
 [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Arylmera-40DCA5?style=for-the-badge&logo=buymeacoffee&logoColor=black)](https://www.buymeacoffee.com/Arylmera)
 
+![Rust](https://img.shields.io/badge/Rust-1.82-000000?logo=rust&logoColor=white)
+![Tauri](https://img.shields.io/badge/Tauri-2.0-24C8DB?logo=tauri&logoColor=white)
+![React](https://img.shields.io/badge/React-18.3-61DAFB?logo=react&logoColor=black)
+![esbuild](https://img.shields.io/badge/esbuild-0.24-FFCF00?logo=esbuild&logoColor=black)
+![License](https://img.shields.io/badge/License-MIT-3DA639?logo=opensourceinitiative&logoColor=white)
+
 ![Token Dashboard overview](docs/images/dashboard-wide.png)
 
 ## Install
 
@@ -1,6 +1,6 @@
 [package]
 name = "token-dashboard-cli"
-version = "4.1.4"
+version = "4.1.5"
 edition.workspace = true
 license.workspace = true
 repository.workspace = true
 
@@ -97,6 +97,15 @@
           "cache_create_1h_tokens": { "type": "integer", "format": "int64" }
         }
       },
+      "HeatmapCell": {
+        "type": "object",
+        "description": "One activity bucket. dow follows strftime('%w') (0=Sun..6=Sat) in the machine's local timezone; hour is 0-23. Only non-empty buckets are returned.",
+        "properties": {
+          "dow": { "type": "integer", "format": "int64" },
+          "hour": { "type": "integer", "format": "int64" },
+          "turns": { "type": "integer", "format": "int64" }
+        }
+      },
       "PhaseSplit": {
         "type": "object",
         "properties": {
@@ -389,6 +398,16 @@
         "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/HourlySlot" } } } } } }
       }
     },
+    "/api/activity": {
+      "get": {
+        "tags": ["read"],
+        "summary": "Turn counts bucketed by local weekday + hour (activity heatmap)",
+        "parameters": [
+          { "name": "days", "in": "query", "schema": { "type": "integer", "default": 7, "minimum": 1 } }
+        ],
+        "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/HeatmapCell" } } } } } }
+      }
+    },
     "/api/phase-split": {
       "get": {
         "tags": ["read"],
 
@@ -26,12 +26,13 @@ use token_dashboard_core::{
     limits::LimitsSnapshot,
     list_sources, preferences,
     queries::{
-        add_session_tag, all_tags, daily_token_breakdown, dismiss_tip, expensive_prompts,
-        first_prompts, get_plan, hourly_breakdown, model_breakdown, normalise_tag, overview_totals,
-        phase_split, project_summary, recent_sessions, remove_session_tag, session_model_usage,
-        session_tags, session_turns, set_plan, skill_breakdown, tag_aggregates, tag_session_counts,
-        tool_token_breakdown, DailyRow, ExpensivePromptRow, ModelRow, OverviewTotals, ProjectRow,
-        SessionRow, SessionTurn, SkillRow, TagRow, ToolRow,
+        activity_heatmap, add_session_tag, all_tags, daily_token_breakdown, dismiss_tip,
+        expensive_prompts, first_prompts, get_plan, hourly_breakdown, model_breakdown,
+        normalise_tag, overview_totals, phase_split, project_summary, recent_sessions,
+        remove_session_tag, session_model_usage, session_tags, session_turns, set_plan,
+        skill_breakdown, tag_aggregates, tag_session_counts, tool_token_breakdown, DailyRow,
+        ExpensivePromptRow, HeatmapCell, ModelRow, OverviewTotals, ProjectRow, SessionRow,
+        SessionTurn, SkillRow, TagRow, ToolRow,
     },
     scan_dir, Pricing, ScanStats, Source, Usage,
 };
@@ -541,6 +542,28 @@ pub(crate) async fn hourly(
     Ok(Json(slots))
 }
 
+#[derive(Deserialize)]
+pub(crate) struct ActivityQs {
+    pub(crate) days: Option<i64>,
+    pub(crate) provider: Option<String>,
+}
+
+/// Activity heatmap: turn counts bucketed by local weekday and hour over the
+/// last `days` days (default 7). Aggregated in SQL with no session-row cap,
+/// so it reflects the whole window rather than the most recent N sessions.
+pub(crate) async fn activity(
+    State(s): State<AppState>,
+    Query(q): Query<ActivityQs>,
+) -> Result<Json<Vec<HeatmapCell>>, ApiError> {
+    let path = s.db_path.clone();
+    let days = q.days.unwrap_or(7).max(1);
+    let provider = q.provider.clone();
+    let rows = blocking(move || activity_heatmap(path.as_ref(), days, provider.as_deref()))
+        .await?
+        .0;
+    Ok(Json(rows))
+}
+
 #[derive(Serialize, Default, Clone, Copy)]
 pub(crate) struct PhaseBin {
     pub(crate) turns: i64,
@@ -2319,6 +2342,7 @@ pub fn app(state: AppState) -> Router {
         .route("/api/tags", get(tags))
         .route("/api/tags-summary", get(tags_summary))
         .route("/api/hourly", get(hourly))
+        .route("/api/activity", get(activity))
         .route("/api/phase-split", get(phase_split_endpoint))
         .route("/api/prompts", get(prompts))
         .route("/api/skills", get(skills))
 
@@ -1,6 +1,6 @@
 [package]
 name = "token-dashboard-core"
-version = "4.1.4"
+version = "4.1.5"
 edition.workspace = true
 license.workspace = true
 repository.workspace = true
 
@@ -395,6 +395,51 @@ pub fn hourly_breakdown<P: AsRef<Path>>(
     rows.collect()
 }
 
+/// One (weekday, hour) bucket of the activity heatmap. `dow` follows
+/// SQLite's `strftime('%w')` convention (0 = Sunday … 6 = Saturday) and
+/// `hour` is 0–23. Both are computed in the machine's local timezone so
+/// the heatmap matches the user's wall clock.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct HeatmapCell {
+    pub dow: i64,
+    pub hour: i64,
+    pub turns: i64,
+}
+
+/// User-prompt ("turn") counts bucketed by local weekday and hour over the
+/// last `days` days. A turn is one `type='user'` message — the same unit
+/// `recent_sessions` reports. Aggregated entirely in SQL with no row cap so
+/// the heatmap reflects the whole window, not just the most recent sessions.
+pub fn activity_heatmap<P: AsRef<Path>>(
+    db: P,
+    days: i64,
+    provider: Option<&str>,
+) -> rusqlite::Result<Vec<HeatmapCell>> {
+    let c = open_ro(db)?;
+    let cutoff = format!("-{} days", days.max(1));
+    let (prov, prov_args) = provider_clause(provider);
+    let sql = format!(
+        "SELECT CAST(strftime('%w', timestamp, 'localtime') AS INTEGER) AS dow, \
+                CAST(strftime('%H', timestamp, 'localtime') AS INTEGER) AS hour, \
+                COUNT(*) AS turns \
+         FROM messages \
+         WHERE type='user' AND timestamp IS NOT NULL \
+           AND timestamp >= datetime('now', ?){prov} \
+         GROUP BY dow, hour"
+    );
+    let mut stmt = c.prepare(&sql)?;
+    let mut args: Vec<String> = vec![cutoff];
+    args.extend(prov_args);
+    let rows = stmt.query_map(rusqlite::params_from_iter(args.iter()), |r| {
+        Ok(HeatmapCell {
+            dow: r.get(0)?,
+            hour: r.get(1)?,
+            turns: r.get(2)?,
+        })
+    })?;
+    rows.collect()
+}
+
 pub const PLAN_TOOLS: &[&str] = &[
     "Read",
     "Grep",
 
@@ -0,0 +1,70 @@
+//! Verifies that `queries::activity_heatmap` aggregates user-turn counts by
+//! local weekday/hour over the trailing window, counting only `type='user'`
+//! messages and excluding anything older than the window. Timestamps are
+//! seeded relative to `now` so the test is independent of the wall clock,
+//! and assertions avoid pinning specific weekday/hour buckets (which shift
+//! with the machine timezone) — they check totals and the type/window
+//! filters instead.
+
+use rusqlite::Connection;
+use tempfile::TempDir;
+use token_dashboard_core::init_db;
+use token_dashboard_core::queries::activity_heatmap;
+
+fn seed(c: &Connection, uuid: &str, mtype: &str, ts_expr: &str) {
+    // ts_expr is a SQL datetime() expression so timestamps stay relative to
+    // the test's "now" and always land inside (or outside) the window.
+    c.execute(
+        &format!(
+            "INSERT INTO messages (uuid, session_id, project_slug, type, timestamp, \
+              input_tokens, output_tokens, cache_read_tokens, cache_create_5m_tokens, cache_create_1h_tokens) \
+             VALUES (?, 's1', 'p1', ?, {ts_expr}, 0, 0, 0, 0, 0)"
+        ),
+        rusqlite::params![uuid, mtype],
+    )
+    .unwrap();
+}
+
+#[test]
+fn counts_only_recent_user_turns() {
+    let tmp = TempDir::new().unwrap();
+    let db = tmp.path().join("td.db");
+    init_db(&db).unwrap();
+    let c = Connection::open(&db).unwrap();
+
+    // Three user turns inside the 7-day window, at two distinct moments.
+    seed(&c, "u1", "user", "datetime('now','-2 days')");
+    seed(&c, "u2", "user", "datetime('now','-2 days')");
+    seed(&c, "u3", "user", "datetime('now','-5 days')");
+    // Assistant message inside the window — must be ignored (not a turn).
+    seed(&c, "a1", "assistant", "datetime('now','-1 days')");
+    // User turn outside the window — must be excluded.
+    seed(&c, "old", "user", "datetime('now','-10 days')");
+
+    let cells = activity_heatmap(&db, 7, None).unwrap();
+    let total: i64 = cells.iter().map(|c| c.turns).sum();
+    assert_eq!(total, 3, "only the 3 in-window user turns count");
+
+    for cell in &cells {
+        assert!(
+            (0..=6).contains(&cell.dow),
+            "dow in 0..=6, got {}",
+            cell.dow
+        );
+        assert!(
+            (0..=23).contains(&cell.hour),
+            "hour in 0..=23, got {}",
+            cell.hour
+        );
+        assert!(cell.turns > 0, "no zero-count rows emitted");
+    }
+}
+
+#[test]
+fn empty_db_yields_no_cells() {
+    let tmp = TempDir::new().unwrap();
+    let db = tmp.path().join("td.db");
+    init_db(&db).unwrap();
+    let cells = activity_heatmap(&db, 7, None).unwrap();
+    assert!(cells.is_empty());
+}
@@ -1,6 +1,6 @@
 [package]
 name = "token-dashboard-tauri"
-version = "4.1.4"
+version = "4.1.5"
 edition.workspace = true
 license.workspace = true
 repository.workspace = true
 
@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "Token Dashboard",
-  "version": "4.1.4",
+  "version": "4.1.5",
   "identifier": "com.arylmera.token-dashboard",
   "build": {
     "frontendDist": "frontend-stub"
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://schema.tauri.app/config/2",`
`3`	`3`	`"productName": "Token Dashboard",`
`4`		`- "version": "4.1.4",`
	`4`	`+ "version": "4.1.5",`
`5`	`5`	`"identifier": "com.arylmera.token-dashboard",`
`6`	`6`	`"build": {`
`7`	`7`	`"frontendDist": "frontend-stub"`