Fuel

Terminal-first Fuel manager. Keep your home management data organized with simple commands.

Security Scan

The skill is a simple, local CLI that stores entries under ~/.local/share/fuel and its files match the claimed purpose, but the bundle omits installation instructions and keeps plaintext logs that the user should be aware of.

Purpose & Capability

The name/description (a terminal-first fuel/home management tool) aligns with the included Bash script which implements CLI commands and stores data under ~/.local/share/fuel. Minor incoherence: the SKILL.md shows usage as a 'fuel' command but the package includes scripts/script.sh and provides no install spec or instructions to place that script on PATH, so the CLI won't be available out-of-the-box unless the user installs or symlinks it themselves.

Instruction Scope

SKILL.md and the script operate entirely on local files and standard utilities (du, cat, tail, grep, etc.). There are no instructions to read unrelated system files or to transmit data externally in the provided content. Commands and file paths referenced stay within the stated data directory.

Install Mechanism

There is no install specification (low-risk) but a runnable script is included in the bundle. That is not inherently dangerous, but it is a packaging mismatch: the skill claims CLI usage yet provides no automated install step to make the CLI available. Users should be aware the script will need to be placed into PATH or executed explicitly.

Credentials

The skill requests no environment variables or credentials. It does rely on HOME and writes to ~/.local/share/fuel, which is expected. However, all user inputs are stored as plaintext logs and exports (json/csv/txt) in that directory — sensitive data (passwords, tokens, personal info) entered into entries would be stored unencrypted and accessible to other local users/processes. No secrets are requested, but the storage practice has privacy implications.

Persistence & Privilege

The skill does not request permanent platform-wide privileges (always:false) and does not modify other skills or global agent settings. Its persistent footprint is confined to a directory in the user's home.

Assessment

This skill appears to do what it says: a local CLI that logs entries to ~/.local/share/fuel. Before installing or running it: 1) review the full script (the bundle contains scripts/script.sh) to confirm there are no network calls or unexpected behavior in the truncated portion; 2) be aware that all entries are stored as plaintext — avoid entering secrets or sensitive data; 3) if you expect a 'fuel' command, you must install the script yourself (make executable and place on PATH or create a symlink); 4) verify the source (BytesAgain) and consider running the script in a restricted environment (container or limited user) if you want to limit risk; 5) check file permissions of ~/.local/share/fuel after first run to ensure other local users cannot read your logs.

Terminal-first Fuel manager. Keep your home management data organized with simple commands.

Why Fuel?

• 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

Getting Started

# See what you can do
fuel help

# Check current status
fuel status

# View your statistics
fuel stats

Commands

Command	What it does
fuel add	Add
fuel inventory	Inventory
fuel schedule	Schedule
fuel remind	Remind
fuel checklist	Checklist
fuel usage	Usage
fuel cost	Cost
fuel maintain	Maintain
fuel log	Log
fuel report	Report
fuel seasonal	Seasonal
fuel tips	Tips
fuel stats	Summary statistics
fuel export	<fmt> Export (json
fuel search	<term> Search entries
fuel recent	Recent activity
fuel status	Health check
fuel help	Show this help
fuel version	Show version
fuel $name:	$c entries
fuel Total:	$total entries
fuel Data	size: $(du -sh "$DATA_DIR" 2>/dev/null
fuel Version:	v2.0.0
fuel Data	dir: $DATA_DIR
fuel Entries:	$(cat "$DATA_DIR"/*.log 2>/dev/null
fuel Disk:	$(du -sh "$DATA_DIR" 2>/dev/null
fuel Last:	$(tail -1 "$DATA_DIR/history.log" 2>/dev/null
fuel Status:	OK
fuel [Fuel]	add: $input
fuel Saved.	Total add entries: $total
fuel [Fuel]	inventory: $input
fuel Saved.	Total inventory entries: $total
fuel [Fuel]	schedule: $input
fuel Saved.	Total schedule entries: $total
fuel [Fuel]	remind: $input
fuel Saved.	Total remind entries: $total
fuel [Fuel]	checklist: $input
fuel Saved.	Total checklist entries: $total
fuel [Fuel]	usage: $input
fuel Saved.	Total usage entries: $total
fuel [Fuel]	cost: $input
fuel Saved.	Total cost entries: $total
fuel [Fuel]	maintain: $input
fuel Saved.	Total maintain entries: $total
fuel [Fuel]	log: $input
fuel Saved.	Total log entries: $total
fuel [Fuel]	report: $input
fuel Saved.	Total report entries: $total
fuel [Fuel]	seasonal: $input
fuel Saved.	Total seasonal entries: $total
fuel [Fuel]	tips: $input
fuel Saved.	Total tips entries: $total

Data Storage

All data is stored locally at ~/.local/share/fuel/. Each action is logged with timestamps. Use export to back up your data anytime.

Feedback

Found a bug or have a suggestion? Let us know: https://bytesagain.com/feedback/

---

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