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?

Commands

| Command | Description | |---------|-------------| | sensor run | Run a sensor task (or view recent runs with no args) | | sensor check | Check sensor readings or device connectivity | | sensor convert | Convert between units or data formats | | sensor analyze | Analyze telemetry trends and patterns | | sensor generate | Generate sensor configurations or test data | | sensor preview | Preview a sensor operation before executing | | sensor batch | Batch-process multiple sensor readings | | sensor compare | Compare sensor readings across devices or time periods | | sensor export | Log an export operation (or view recent exports) | | sensor config | Store or review sensor configuration settings | | sensor status | Log a device status update (or view recent status entries) | | sensor report | Generate or log a sensor data report | | sensor stats | Show summary statistics across all categories | | sensor export | Export all data (formats: json, csv, txt) | | sensor search | 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:

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

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

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

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