Mileage

A focused home management tool built for Mileage. Log entries, review trends, and export reports — all locally.

Security Scan

The skill is a locally‑focused CLI for personal/home records that reads/writes files in your home directory and does not request credentials or network access, but the packaging/instructions are slightly inconsistent (script included but no install guidance).

Purpose & Capability

The name/description claim a local home-management CLI and the shipped script implements that behavior (reads/writes under ~/.local/share/mileage, provides add/inventory/report/export/stats). However, SKILL.md assumes a 'mileage' command exists while there is no install spec or explicit install instructions — the bundle contains scripts/script.sh but does not explain how that becomes the 'mileage' command. This is an operational inconsistency (usability/packaging) rather than a security mismatch.

Instruction Scope

SKILL.md and the script's runtime instructions operate purely on local files under $HOME/.local/share/mileage and on standard shell utilities (grep, tail, du, wc, sed). The instructions do not request unrelated system files, additional credentials, or network calls. The SKILL.md references a feedback URL, but the shipped script does not contact network endpoints.

Install Mechanism

No install specification is provided (instruction-only), which is low risk. However, the package includes a runnable script but offers no guidance for installing or registering it as the 'mileage' command. That omission is a packaging/usability gap and could lead users to execute the script manually without guidance.

Credentials

The skill requires no environment variables or credentials. It only reads $HOME to construct a data directory and uses no SECRET/TOKEN-like variables. This is proportionate to the stated purpose.

Persistence & Privilege

The skill does not request persistent platform privileges (always:false). It writes only to its own data directory under the user's home and does not modify other skills or system-wide settings.

Assessment

This skill appears to do what it says: a local CLI that stores data under ~/.local/share/mileage and has no network or credential requirements. Before installing or running it: (1) note there are no install instructions — you may need to review and run scripts/script.sh manually or create a symlink/installation for the 'mileage' command; (2) inspect the script yourself (it is included) and consider running it in a sandbox if you're unsure; (3) expect user data to be stored in ~/.local/share/mileage (back it up if needed); and (4) the SKILL.md lists a feedback URL (bytesagain.com) but the tool itself does not contact that endpoint. If you want automatic installation or packaged distribution, ask the publisher for clear install steps or a packaged release.

A focused home management tool built for Mileage. Log entries, review trends, and export reports — all locally.

Why Mileage?

• 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
mileage help

# Check current status
mileage status

# View your statistics
mileage stats

Commands

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

Data Storage

All data is stored locally at ~/.local/share/mileage/. 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]