Sensor

Read and manage IoT sensor data from the terminal. Use when polling readings, checking device connectivity, converting units, analyzing telemetry trends.

BytesAgain2@ckchzh

Install

openclaw skills install @ckchzh/sensor

Sensor

A terminal-first utility toolkit for managing sensor data. Log readings, check device status, analyze telemetry, generate reports, and export data — all with timestamped logging and full export support.

Why Sensor?

Works entirely offline — your data never leaves your machine
Simple command-line interface, no GUI needed
Export to JSON, CSV, or plain text anytime
Automatic history and activity logging
Each command maintains its own dedicated log file

Commands

Command	Description
`sensor run <input>`	Run a sensor task (or view recent runs with no args)
`sensor check <input>`	Check sensor readings or device connectivity
`sensor convert <input>`	Convert between units or data formats
`sensor analyze <input>`	Analyze telemetry trends and patterns
`sensor generate <input>`	Generate sensor configurations or test data
`sensor preview <input>`	Preview a sensor operation before executing
`sensor batch <input>`	Batch-process multiple sensor readings
`sensor compare <input>`	Compare sensor readings across devices or time periods
`sensor export <input>`	Log an export operation (or view recent exports)
`sensor config <input>`	Store or review sensor configuration settings
`sensor status <input>`	Log a device status update (or view recent status entries)
`sensor report <input>`	Generate or log a sensor data report
`sensor stats`	Show summary statistics across all categories
`sensor export <fmt>`	Export all data (formats: json, csv, txt)
`sensor search <term>`	Search across all logged entries
`sensor recent`	Show the 20 most recent activity log entries
`sensor status`	Health check — version, data dir, entry count, disk usage
`sensor help`	Show full usage information
`sensor version`	Show version (v2.0.0)

Each action command works in two modes:

With arguments: saves the input with a timestamp to <command>.log and logs to history
Without arguments: displays the 20 most recent entries for that command

Data Storage

All data is stored locally in ~/.local/share/sensor/. Each command writes to its own dedicated log file (e.g., run.log, check.log, analyze.log). A unified history.log tracks all activity with timestamps. Data never leaves your machine.

Directory structure:

text

~/.local/share/sensor/
├── run.log
├── check.log
├── convert.log
├── analyze.log
├── generate.log
├── preview.log
├── batch.log
├── compare.log
├── export.log
├── config.log
├── status.log
├── report.log
└── history.log

Requirements

Bash (with set -euo pipefail)
Standard Unix utilities: date, wc, du, tail, grep, sed, cat
No external dependencies or network access required

When to Use

Logging IoT sensor readings from the field — use run and check to record temperature, humidity, pressure, or other sensor readings with automatic timestamps
Analyzing telemetry trends across devices — use analyze and compare to identify patterns in sensor data and spot anomalies between devices or time periods
Converting sensor data between units — use convert to log unit conversions (Celsius to Fahrenheit, PSI to bar, etc.) and keep a record of transformations
Generating periodic sensor reports — use report, stats, and export to compile sensor data into JSON, CSV, or text formats for dashboards or stakeholder reviews
Batch-processing multi-device sensor data — use batch and config to handle bulk sensor operations and maintain device configuration records

Examples

bash

# Log a temperature reading
sensor run "Sensor-A3: 23.5°C at warehouse zone B"

# Check device connectivity status
sensor check "Gateway-01: online, 12 sensors connected, latency 45ms"

# Analyze a telemetry trend
sensor analyze "Temperature drift: +0.3°C/hour over last 6 hours in cold storage"

# Export all sensor data as CSV for analysis
sensor export csv

# Search for all entries related to a specific sensor
sensor search "Sensor-A3"

Configuration

Set the SENSOR_DIR environment variable to change the data directory. Default: ~/.local/share/sensor/

Output

All commands output results to stdout. Redirect to a file with > output.txt if needed. The export command writes directly to ~/.local/share/sensor/export.<fmt>.