← Back to Skills Marketplace
mjrussell

Beestat

by Matt Russell · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
1949
Downloads
1
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install beestat
Description
Query ecobee thermostat data via Beestat API including temperature, humidity, air quality (CO2, VOC), sensors, and HVAC runtime. Use when user asks about home temperature, thermostat status, air quality, or heating/cooling usage.
README (SKILL.md)

Beestat CLI

CLI for the Beestat API (ecobee thermostat analytics). Query temperature, humidity, air quality, and HVAC runtime.

Installation

npm install -g beestat-cli

Setup

  1. Create account at beestat.io and link your ecobee
  2. Email [email protected] with your thermostat serial number to get an API key
  3. Set environment variable: export BEESTAT_API_KEY="your-key"

Commands

Status

beestat status             # Current temps, humidity, setpoints, weather
beestat status --json

Sensors

beestat sensors            # All sensors with temperature and occupancy
beestat sensors --json

Air Quality

beestat air-quality        # CO2, VOC, and air quality score
beestat aq                 # Short alias
beestat aq --json

Requires ecobee Smart Thermostat Premium (has built-in air quality sensors).

CO2 Levels:

  • \x3C 800 ppm: Excellent
  • 800-1000 ppm: Good
  • 1000-1500 ppm: Fair (consider ventilation)
  • 1500 ppm: High (ventilate!)

VOC Levels:

  • \x3C 0.5 ppm: Excellent
  • 0.5-1.0 ppm: Good
  • 1.0-3.0 ppm: Fair
  • 3.0 ppm: High

Thermostats

beestat thermostats        # Model info, HVAC details
beestat thermostats --json

Runtime Summary

beestat summary            # Runtime history (default 7 days)
beestat summary --days 14  # Last 14 days
beestat summary --json

Force Sync

beestat sync               # Force sync with ecobee

Usage Examples

User: "What's the temperature in the house?"

beestat status

User: "Is the air quality okay?"

beestat aq

User: "Is anyone in the bedrooms?"

beestat sensors

User: "How much did we heat the house this week?"

beestat summary --days 7

User: "What thermostats do we have?"

beestat thermostats

Notes

  • Air quality data comes from ecobee runtime, not sensor capabilities
  • All commands support --json for scripting/automation
  • Use beestat sync if data seems stale
Usage Guidance
Before installing or enabling this skill: (1) resolve the metadata mismatch — confirm whether the skill actually requires the beestat CLI and BEESTAT_API_KEY, (2) verify the npm package publisher and inspect the package (or run in a sandbox) before performing a global `npm install -g`, (3) obtain an API key with the minimum scope possible and be ready to revoke it if anything looks suspicious, (4) confirm the contact email and homepage (beestat.io) are legitimate, and (5) if you allow the agent to invoke skills autonomously, be aware that this skill will have network access to the Beestat API when invoked. If you need higher assurance, ask the skill author for source code or a signed release link (GitHub release) rather than installing an opaque npm package.
Capability Analysis
Type: OpenClaw Skill Name: beestat Version: 0.1.0 The skill bundle defines a legitimate purpose: querying ecobee thermostat data via the Beestat API using a CLI. The `SKILL.md` provides standard installation instructions (`npm install -g beestat-cli`) and usage examples that are consistent with the stated goal. There is no evidence of prompt injection against the agent, data exfiltration, malicious execution, persistence mechanisms, or obfuscation within the provided files. The required environment variable `BEESTAT_API_KEY` is a standard practice for API access.
Capability Assessment
Purpose & Capability
The SKILL.md describes a CLI that queries Beestat/ecobee data and requires the beestat CLI plus BEESTAT_API_KEY — this is coherent with the stated purpose. HOWEVER the registry metadata shown to the scanner lists no required binaries or env vars while the SKILL.md metadata declares bins:["beestat"] and env:["BEESTAT_API_KEY"]. That mismatch is an inconsistency in the package metadata that should be resolved.
Instruction Scope
The instructions are narrowly scoped: they tell the user to install an npm package, obtain an API key from beestat.io, set BEESTAT_API_KEY, and run CLI commands to fetch thermostat, sensor, and air-quality data. There are no instructions to read unrelated local files or exfiltrate data outside the Beestat API.
Install Mechanism
This is an instruction-only skill that advises running `npm install -g beestat-cli`. Installing a global npm package is a common delivery method but has moderate supply-chain risk (npm package integrity, publisher identity, post-install hooks). The registry contains no automated install spec — the install step is manual and therefore under the user's control, but you should verify the npm package and publisher before installing.
Credentials
Requesting a single BEESTAT_API_KEY is proportionate to a service that calls the Beestat API. The concern is the metadata inconsistency: the public registry/skill summary claims no required env vars while the SKILL.md requires BEESTAT_API_KEY. Ensure the agent/platform will not demand broader credentials and confirm the key's intended scope before providing it.
Persistence & Privilege
The skill does not request 'always: true' and does not declare persistence or system-wide configuration changes. It is user-invocable and may be invoked autonomously per platform defaults, which is expected for skills and is not by itself a red flag.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install beestat
  3. After installation, invoke the skill by name or use /beestat
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release - ecobee thermostat via Beestat API
Metadata
Slug beestat
Version 0.1.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Beestat?

Query ecobee thermostat data via Beestat API including temperature, humidity, air quality (CO2, VOC), sensors, and HVAC runtime. Use when user asks about home temperature, thermostat status, air quality, or heating/cooling usage. It is an AI Agent Skill for Claude Code / OpenClaw, with 1949 downloads so far.

How do I install Beestat?

Run "/install beestat" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Beestat free?

Yes, Beestat is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Beestat support?

Beestat is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Beestat?

It is built and maintained by Matt Russell (@mjrussell); the current version is v0.1.0.

💬 Comments