Skip to content

jongio/thermoworks

Repository files navigation

πŸ”₯ ThermoWorks Tools

CI npm: thermoworks npm: thermoworks-sdk VS Code Marketplace License: MIT Node.js

Disclaimer: This project is not affiliated with, endorsed by, or connected to ThermoWorks in any way. It is an unofficial, community-built tool created by ThermoWorks customers for personal use.

See live temperatures from your ThermoWorks Cloud devices in the GitHub Copilot app canvas, terminal, GitHub Copilot CLI statusline, VS Code status bar, or a full device panel β€” with color-coded alarm alerts and firmware update notifications.


πŸ†• ThermoWorks Canvas for the GitHub Copilot app

Monitor your live cooks inside the GitHub Copilot app β€” an animated, fire-vibe canvas with real-time probe temps, interactive temperature graphs, target tracking, time‑to‑done estimates, high/low alarms, and an AI pit master you can chat with. Pick any of your devices/sessions to watch, or explore the built‑in cook simulator with zero setup.

ThermoWorks canvas β€” live cook dashboard with two probes and a multi-line graph

Install in the GitHub Copilot app

In the GitHub Copilot app, just tell it:

install thermoworks canvas jongio/thermoworks

Then open it and say "watch my cook" (or pick a device). It opens in demo mode out of the box β€” sign in from the canvas to switch to your live devices. No terminal required.

Built with the create-canvas-app skill from jongio/skills. See the canvas README for details.

Highlights

  • πŸ”₯ Animated fire dashboard β€” flickering flames, rising embers, alarm pulse.
  • πŸ“ˆ Interactive SVG graph β€” per‑channel target lines, the 148–168Β°F stall band, hover crosshair + tooltip.
  • πŸ– Live gauges β€” rate of change, progress bars, time‑to‑done ETAs, "READY" celebration.
  • πŸ€– Ask the Pit Master β€” an AI BBQ expert grounded in your live temps.
  • πŸ”Œ In‑canvas sign‑in β€” connect to ThermoWorks Cloud without a console; pick any device/session, or watch them all.
  • 🎬 Demo mode β€” a realistic cook simulator that works with zero credentials.

Interactive temperature history graph with target lines, stall band, and a hover tooltip

πŸ€– Ask the Pit Master

The canvas ships with Smokey, an AI pit master you can chat with right next to your cook β€” the part nothing else here does. Every answer is grounded in your live cook data: it reads the actual pit and probe temps, rate of change, target gaps, and time‑to‑done estimates on screen, so the advice is specific to this cook β€” diagnosing the stall, when to wrap, doneness, food safety, and timing.

Ask the Pit Master β€” an AI BBQ expert chat grounded in your live cook temperatures

  • Grounded, not generic. Smokey is handed a live snapshot of your cook, so it cites your real numbers ("your flat at 160Β°F, climbing +0.2Β°F/min, ~3.5h out").
  • No API keys. It uses the GitHub Copilot app's own model β€” nothing to configure, no separate account.
  • Shared with the agent. The same chat is driveable by you (one‑tap suggestion chips or free text) and by the Copilot agent, over the same state.

Products

πŸ”₯ VS Code Extension

Full sidebar device panel + status bar integration. See all your devices, channels, battery, firmware status, and alarm states embedded in your editor.

ThermoWorks device panel in VS Code

Install: Search "ThermoWorks" in VS Code Extensions, or get it from the Marketplace.

⌨️ CLI + Copilot Statusline

Live temperatures in your terminal footer while you code. Interactive wizard to pick devices and channels. 19 commands for device monitoring, alarms, sessions, data export, and more.

ThermoWorks statusline in GitHub Copilot CLI

ThermoWorks statusline with per-channel display

Install: npx thermoworks

🌐 Web Dashboard

Real-time temperature dashboard with Recharts history graphs, alarm color coding, light/dark theme, and public share viewer β€” all in the browser. Built with React 19, Vite, and Tailwind CSS.

Live: jongio.github.io/thermoworks

Run locally:

# Clone and start the dev server
git clone https://github.com/jongio/thermoworks.git
cd thermoworks && pnpm install
pnpm --filter thermoworks-web dev

πŸ› οΈ SDK

Node.js SDK for programmatic access β€” build your own dashboards, alerts, or automations with full access to devices, channels, events, archives, calibration data, and more.

Install: npm install thermoworks-sdk

πŸ€– MCP Server

Model Context Protocol server that exposes your ThermoWorks device data to AI assistants like GitHub Copilot, Claude, and ChatGPT.

Start:

# Via npx (no install needed)
npx thermoworks mcp start

# Or if installed globally
thermoworks mcp start

Quick Start

# Sign in to ThermoWorks Cloud
npx thermoworks auth login

# List your devices with channel readings
npx thermoworks devices

# Watch temperatures live (auto-refresh)
npx thermoworks watch

# Run the Copilot statusline setup wizard
npx thermoworks copilot setup

For command details, see the CLI reference.


Feature Highlights

🚨 Temperature Alerts

Instant visual alarms when temperatures cross thresholds β€” red for too high, blue for too low. VS Code blinks the status bar; the CLI uses ANSI color codes.

VS Code high alarm β€” red background

VS Code low alarm β€” blue text

CLI high alarm β€” red ANSI text

CLI low alarm β€” blue ANSI text

⬆️ Firmware Update Alerts

Automatically detects outdated device firmware by comparing against the latest version from ThermoWorks Cloud. Orange warning visible at every tree level β€” device folder, device node, and expanded details.

Firmware update alert in VS Code

πŸ“Š Per-Channel Selection

Pick averages or individual channels for multi-probe devices like the Signals 4-channel or Smoke 2-channel.

πŸ” Secure Credential Storage

Credentials stored in the OS keychain (macOS Keychain, Windows Credential Vault, libsecret). Sign in once β€” CLI and VS Code share access. Environment variables (THERMOWORKS_EMAIL / THERMOWORKS_PASSWORD) supported for headless environments.

πŸ”” Activity Bar Badge

The fire icon in the VS Code Activity Bar shows a badge count of devices with active alarms β€” you'll know something needs attention without even opening the panel.

πŸ”— Cloud Dashboard Link

One-click link to cloud.thermoworks.com from within the VS Code panel.

🎬 Demo Mode

Test alarm styling and take screenshots without real credentials:

# CLI one-shot demo
npx thermoworks demo high    # red text
npx thermoworks demo low     # blue text
npx thermoworks demo normal  # no color

# Auto-cycling statusline demo
npx thermoworks copilot setup --demo

In VS Code: Command Palette β†’ ThermoWorks: Demo (Simulate Alarm) β€” populates the full panel and status bar with fake devices.


Packages

Package Description
thermoworks canvas πŸ†• GitHub Copilot app canvas β€” live cook dashboard, interactive graphs, AI pit master, in-canvas sign-in
thermoworks CLI for authentication, Copilot statusline setup, device listing, MCP server, and demo mode
thermoworks-sdk Node.js SDK for programmatic access to ThermoWorks Cloud
thermoworks-mcp MCP server exposing device data to AI assistants (GitHub Copilot, Claude, ChatGPT)
thermoworks-web Local web dashboard with real-time temperature display, history charts, and public share viewer
ThermoWorks for VS Code Extension with status bar, device panel, alarm indicators, and firmware alerts

Documentation

Development

This repository uses pnpm workspaces.

# Install dependencies
pnpm install

# Lint the monorepo
pnpm lint

# Run tests
pnpm test

# Build all packages
pnpm build

# Type-check all packages
pnpm typecheck

Agent Skills

This project includes GitHub Copilot agent skills in .github/skills/ that help AI coding assistants work with the codebase:

Skill Description
thermoworks Integration guide for reading temperatures, monitoring alarms, and using the CLI
thermoworks-dev Development guide for adding features, understanding conventions, and building

Skills are auto-discovered by GitHub Copilot and activated when relevant to your task.

Skill Evaluation (Vally)

Eval suites in evals/ validate that agent skills produce correct guidance, powered by @microsoft/vally:

# Validate eval specs (fast, no execution)
pnpm eval:lint

# Run smoke suite
pnpm eval:smoke

# Run full evaluation
pnpm eval:full

License

MIT

About

Monitor ThermoWorks Cloud devices everywhere - CLI with live statusline, VS Code extension, real-time web dashboard, Node.js SDK, MCP server for AI assistants, and GitHub Copilot agent skills with evals.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages