sensor

name	Sensor
description	Read and manage IoT sensor data from the terminal. Use when polling readings, checking device connectivity, converting units, analyzing telemetry trends.
version	1.0.0
author	BytesAgain
homepage	https://bytesagain.com
source	https://github.com/bytesagain/ai-skills
tags	["sensor","tool","terminal","cli","utility"]

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:

~/.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

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

Examples

# 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>.

---

Powered by BytesAgain | bytesagain.com | [e-mail]