Algebra

Algebra v2.0.0 — a versatile utility toolkit for recording, tracking, and managing algebra-related tasks from the command line. Log computations, compare results, generate reports, and export your work in multiple formats.

Commands

Command	Description
`algebra run <input>`	Record a run entry (no args = show recent runs)
`algebra check <input>`	Record a check entry (no args = show recent checks)
`algebra convert <input>`	Record a conversion entry (no args = show recent conversions)
`algebra analyze <input>`	Record an analysis entry (no args = show recent analyses)
`algebra generate <input>`	Record a generation entry (no args = show recent generations)
`algebra preview <input>`	Record a preview entry (no args = show recent previews)
`algebra batch <input>`	Record a batch entry (no args = show recent batches)
`algebra compare <input>`	Record a comparison entry (no args = show recent comparisons)
`algebra export <input>`	Record an export entry (no args = show recent exports)
`algebra config <input>`	Record a config entry (no args = show recent configs)
`algebra status <input>`	Record a status entry (no args = show recent statuses)
`algebra report <input>`	Record a report entry (no args = show recent reports)
`algebra stats`	Show summary statistics across all log files
`algebra export <fmt>`	Export all data in json, csv, or txt format
`algebra search <term>`	Search across all entries for a keyword
`algebra recent`	Show the 20 most recent activity entries
`algebra status`	Health check — version, data dir, entry count, disk usage
`algebra help`	Show usage info and available commands
`algebra version`	Show version (v2.0.0)

How It Works

Each command (run, check, convert, analyze, etc.) works as a timestamped log recorder:

With arguments: saves the input to ~/.local/share/algebra/<command>.log with a timestamp, then confirms the entry count.
Without arguments: displays the 20 most recent entries from that command's log file.

All activity is also recorded in a central history.log for cross-command traceability.

Data Storage

Location: ~/.local/share/algebra/
Log files: One .log file per command (e.g., run.log, check.log, analyze.log)
History: history.log — central activity log across all commands
Export: export.json, export.csv, or export.txt generated on demand
Format: Each log line is YYYY-MM-DD HH:MM|<input>

Requirements

Bash (4.0+)
Standard Unix utilities (wc, du, grep, tail, head, date)
No external dependencies or API keys required

When to Use

Tracking algebra homework — log each problem you solve with algebra run "solve x^2 + 3x = 0" and review later with algebra recent
Comparing approaches — use algebra compare "method A vs method B" to record different solution strategies side by side
Batch processing — log batch operations with algebra batch "problems 1-20 chapter 5" to track bulk work sessions
Generating reports — use algebra report "weekly summary" to create traceable report entries, then algebra stats to see totals
Exporting for review — run algebra export json to get all logged data in a structured format for sharing or backup

Examples

# Record an algebra run
algebra run "simplify 3x + 5x - 2"

# Check a result
algebra check "verify x = 4 satisfies 2x + 1 = 9"

# Analyze an expression
algebra analyze "factor x^2 - 9"

# Compare two methods
algebra compare "substitution vs elimination for system of equations"

# Generate a template
algebra generate "quadratic formula template"

# View summary statistics
algebra stats

# Export all data as JSON
algebra export json

# Search for a keyword across all logs
algebra search "quadratic"

# Show recent activity
algebra recent

# Health check
algebra status

Output

Results go to stdout. Save with algebra run > output.txt. All entries are also persisted in the data directory for later retrieval.

Configuration

Set ALGEBRA_DIR environment variable to change the data directory. Default: ~/.local/share/algebra/