Skip to content

v0.1.10

Choose a tag to compare

View all tags
@cristianonescu cristianonescu released this 23 May 14:37
· 3 commits to main since this release
v0.1.10
f74c62e

dashd v0.1.10

Desk widget for developers. A Python agent on your computer collects developer-relevant metrics and streams them to an ESP32-C3 driving a 240×320 ST7789V display — over USB-CDC, Bluetooth LE, or auto-switching between the two. A single tactile button cycles pages.

This is the consolidated v0.1.10 release: everything that landed across v0.1.1 → v0.1.10 in a single coherent description, with the latest binaries attached.

Downloads

Desktop app

Asset Platform
dashd-0.1.10-arm64.dmg macOS (Apple Silicon)
dashd-0.1.10-x64.dmg macOS (Intel)
dashd-0.1.10-x64.exe Windows (x64)
dashd-0.1.10-x86_64.AppImage Linux (any distro, portable)
dashd-0.1.10-amd64.deb Linux (Debian / Ubuntu)

Firmware (ESP32-C3)

Asset Description
dashd-firmware-v0.1.10-ble.bin Full build: USB-CDC + Bluetooth LE
dashd-firmware-v0.1.10-usb.bin USB-only build (smaller, no BLE)

Auto-update metadata

latest-mac.yml, latest-linux.yml, latest.yml, and the .blockmap files are consumed by electron-updater — you don't need to download them manually.

Highlights

Connectivity

  • Bluetooth LE transport — cable-free, 6-digit code pairing shown on the device, trusted-device list, auto-reconnect, log/event forwarding identical to USB. Pick cable / bluetooth / auto from Settings → Connection.
  • USB-CDC at 460800 baud — point-to-point, no driver needed (native USB Serial/JTAG on the ESP32-C3 SuperMini).
  • Sticky agent_status replay — the Electron app sees the device immediately on launch even when it was already plugged in (fixed in v0.1.7).

Display

  • 8 firmware pages — Home, System, AI Spend, Dev Flow, GitHub, Calendar, Messages, Tips. Reorderable, individually enable-able, persisted in NVS.
  • Auto-advance page cycling (default ON, 8 s sequential) — the device cycles through enabled pages on a timer. Toggle, change interval (3–60 s), or switch to randomized Fisher-Yates order from Settings → Pages → Auto-advance. A button press or host page jump resets the countdown so you always get the full interval to read whatever you just selected.
  • Animated pet overlay — Claw'd by default, reacts to commits / meetings / CI / system load. Install new pets from the on-device codexpets.net catalog.
  • Pet install end-to-end working — agent awaits the device's pet_install_started ACK before streaming chunks; CDC RX buffer sized for the 8-chunk burst; LittleFS partition probed at runtime so installs work on every flash-vintage device (littlefs label for v0.1.2+ flashes, falls back to spiffs for v0.1.1 flashes that have been OTA-updating since).

AI usage accuracy

  • Anthropic OAuth Usage API (opt-in, Settings → Privacy) — when enabled, dashd reads your local Claude Code OAuth token and calls Anthropic's /api/oauth/usage endpoint every 60 s. Session %, Weekly %, Sonnet %, Extra Usage all match Claude.ai exactly because they ARE Claude.ai's numbers. Pace metric ("on track / behind / far behind"), will_last_to_reset projection. Token held in memory only, never logged or persisted; macOS Keychain integration via bundled keyring.
  • JSONL-derived usage (always on, fallback) — ccusage-style 5h block segmentation, deduplication by (message_id, request_id), LiteLLM-backed per-model pricing with daily refresh.
  • Tray popover + Usage tab — at-a-glance gauges in a frameless tray panel, deep-dive in the main window. Burn-rate projection, top projects by token count, weekly totals.
  • Codex tokens via cumulative-delta diffing — per-session deltas computed from token_count events; persisted state in ~/.config/dashd/codex_state.json.

Auto-update

  • Electron app self-updates via electron-updater (6-hour periodic check + manual via tray menu + Settings → Updates). DMG + ZIP for mac, NSIS for Windows, AppImage + .deb for Linux.
  • Device firmware updates from the same release page — agent downloads the matching -ble.bin or -usb.bin, streams it over the active transport, the device flashes the inactive OTA slot, verifies SHA256, flips the boot pointer, and reboots. Fullscreen progress overlay on the device. Auto-rollback if the new image fails to come up cleanly via esp_ota_mark_app_valid_cancel_rollback().
  • Dual-slot OTA partition layout — two 1.5 MB app slots + 0.8 MB LittleFS for pet bundles + NVS for prefs + coredump for panics.

Electron UI

  • Live view + Usage tab + full Settings — drag-to-reorder pages, color-zone editor, text-size sliders per role, threshold sliders, brightness, title-bar + footer visibility, screen rotation.
  • VSCode-style dockable logs panel — bottom-right toggle, overlays any tab, filterable by level. Captures both agent logs and device firmware logs.
  • Contextual hint layer — every control has a data-hint tooltip; hover anywhere in Settings to see what it does and what it persists.
  • Menu-bar / system-tray icon — restart, reload config, reset device prefs, autostart toggle, dynamic update controls. Tray-popover shows current usage at a glance without opening the main window.

Collectors

8 active + 3 stubs:

  • System — CPU per-core, RAM (pct + pressure), disk, network, battery, temp, top processes by RAM/CPU.
  • Claude Code — tokens today, cost today, 5h block progress (elapsed + budget %), burn rate, projected cap-hit time, per-model breakdown, weekly totals, top projects.
  • Codex — tokens today, block %, reset time, session active.
  • Git — branch, commits today (filtered by user email), LOC added/removed, minutes since last commit.
  • GitHub — PRs awaiting review, CI failures (24 h), unread notifications. Needs GITHUB_TOKEN.
  • Microsoft Calendar (Graph API) — next event, time-to-next, today's remaining events.
  • Email (IMAP) — unread count from Gmail or any IMAP host. Needs DASHD_EMAIL_PASSWORD.
  • iMessage (macOS only) — unread count from the chat DB. Needs Full Disk Access.
  • Stubs — Slack, Teams, WhatsApp (always return null today).

Notable bug fixes addressed in this consolidated release

  • Pet install broken across all v0.1.2+ devices — LittleFS partition label mismatch silently failed every mount call. Now probed at runtime; works on both v0.1.1 and v0.1.2+ partition layouts.
  • CDC RX buffer overflow — 8 KB buffer overflowed mid pet-install burst; bumped to 32 KB.
  • Anthropic OAuth Keychain path silently broken — keyring library and backends missing from the packaged binary; now bundled.
  • Device shows disconnected at launch — sticky agent_status event replay on IPC subscribe; UI sees the link state immediately.
  • 5h block elapsed stuck at 100 % — ccusage-style block segmentation walks all timestamps in the last 24 h.
  • JSONL re-read dedup — fallback chain msg.id → uuid → requestId → (timestamp,in_tokens,out_tokens) prevents double-counting.

First-launch notes

  • Unsigned binaries — macOS Gatekeeper / Windows SmartScreen will warn the first time:
    • macOS: right-click the app → Open → confirm.
    • Windows: SmartScreen → More info → Run anyway.
  • macOS prompts for Bluetooth permission the first time you scan — required for BLE.
  • macOS prompts for Full Disk Access for iMessage — required by the chat DB on modern macOS.
  • Set GITHUB_TOKEN + DASHD_EMAIL_PASSWORD (and optionally Microsoft Graph creds) to wake the network collectors. See README → Network collector setup.

Flashing firmware (first time)

esptool.py --chip esp32c3 write_flash 0x10000 dashd-firmware-v0.1.10-ble.bin

Or with PlatformIO: cd firmware && pio run -e dashd_ble -t upload.

After the first USB flash, all subsequent firmware updates can happen OTA from Settings → Updates → Device firmware → Update firmware.

Full build, wiring, BLE-pairing, and auto-update documentation in the README.

Assets 19
Loading