Equity

Equity - command-line tool for everyday use

Security Scan

The skill is an offline command-line equity logging/export tool that stores data under ~/.local/share/equity and does not ask for credentials or perform network access; minor documentation vs. implementation mismatches were found.

Purpose & Capability

The name/description (Equity — cap table, dilution, vesting, exports) match the shipped script's behavior: a local CLI that logs entries, lists/searches them, and exports JSON/CSV/TXT. No unexpected cloud or unrelated capabilities are requested.

Instruction Scope

SKILL.md and the script both instruct the user to run local commands and state data is stored under ~/.local/share/equity. However, SKILL.md claims you can set EQUITY_DIR to change the data directory but the provided script does not read an EQUITY_DIR environment variable (it hardcodes DATA_DIR="${HOME}/.local/share/equity"). Also the registry metadata version (1.0.1) differs from the SKILL.md/script version (v2.0.0). These are documentation/implementation inconsistencies but not evidence of malicious behavior.

Install Mechanism

No install spec and the skill is effectively instruction + a shell script. Nothing is downloaded or installed automatically by the skill bundle, so installation risk is low. The script will create files under the user's home directory when run.

Credentials

The skill requires no environment variables or credentials. The only implicit resource is the user's home directory where ~/.local/share/equity is created and log/export files are written. The SKILL.md suggests an EQUITY_DIR env var which the script does not use — a minor incoherence but not a secret-exfiltration issue.

Persistence & Privilege

The skill does not request persistent platform privileges (always:false). Its persistence is limited to creating and updating files under ~/.local/share/equity; it does not modify other skills or system-wide agent settings.

Assessment

This tool appears to be a local CLI that writes logs and exports data under ~/.local/share/equity and does not require network access or secrets. Before installing/running: (1) review the script (it will create and write files in ~/.local/share/equity); (2) note the SKILL.md/implementation mismatch — SKILL.md mentions EQUITY_DIR but the script ignores it, and version numbers differ; (3) if you need a different data directory, modify the script or set up a wrapper that sets DATA_DIR before use; (4) if you keep sensitive data, back it up or secure the data directory because the files are stored in plaintext logs. The missing parts of the provided script output were truncated in the bundle preview — if you want higher confidence, request the full, untruncated script before installing.

Equity calculator — cap table, dilution modeling, vesting schedules, and option pricing.

Commands

Command	Description
equity help	Show usage info
equity run	Run main task
equity status	Check state
equity list	List items
equity add <item>	Add item
equity export <fmt>	Export data

Usage

equity help
equity run
equity status

Examples

equity help
equity run
equity export json

Output

Results go to stdout. Save with equity run > output.txt.

Configuration

Set EQUITY_DIR to change data directory. Default: ~/.local/share/equity/

---

Powered by BytesAgain | bytesagain.com Feedback & Feature Requests: https://bytesagain.com/feedback

Features

• Simple command-line interface for quick access
• Local data storage with JSON/CSV export
• History tracking and activity logs
• Search across all entries

Quick Start

# Check status
equity status

# View help
equity help

# Export data
equity export json

How It Works

Equity stores all data locally in ~/.local/share/equity/. Each command logs activity with timestamps for full traceability.

Support

• Feedback: https://bytesagain.com/feedback/
• Website: https://bytesagain.com

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