MindMap

Multi-purpose utility tool for managing structured data entries. Add, list, search, remove, and export data items — all stored locally in a simple log-based format with full history tracking.

Commands

All commands are invoked via mindmap [args].

Data Storage

• Location: ~/.local/share/mindmap/ (override with MINDMAP_DIR environment variable, or XDG_DATA_HOME)
• Data log: data.log — stores all entries added via add, one per line, prefixed with YYYY-MM-DD
• History: history.log — every command execution is recorded with a timestamp for auditing
• Format: Plain text, one entry per line

Requirements

• Bash 4+
• Standard Unix utilities (date, grep, cat, basename)
• No external dependencies, no API keys, no network access needed

When to Use

1. Quick note-taking — Use mindmap add to jot down ideas, tasks, or observations from the terminal without leaving your workflow
2. Data collection — Accumulate structured entries over time (e.g. daily logs, observations, measurements) and export them for analysis
3. Search and retrieval — Use mindmap search to quickly find entries matching a keyword across your entire data log
4. Automation pipelines — Integrate mindmap add and mindmap export into shell scripts or cron jobs for automated data collection and reporting
5. Lightweight project tracking — Track items, remove completed ones, and list remaining work — all from the command line without heavyweight tools

Examples

# Initialize the data directory
mindmap init

# Add a new entry
mindmap add "Brainstorm: redesign landing page layout"

# Add another entry
mindmap add "TODO: review pull request #42"

# List all entries
mindmap list

# Search for entries containing "redesign"
mindmap search "redesign"

# Export all data to a file
mindmap export > backup.txt

# Check status
mindmap status

# Show version and data path
mindmap info

# Run a custom operation
mindmap run "process weekly report"

Output

All command output goes to stdout. Redirect to save:

mindmap list > all-entries.txt
mindmap export > export-backup.txt

Configuration

Set the MINDMAP_DIR environment variable to change the data directory:

export MINDMAP_DIR="$HOME/my-mindmap-data"
mindmap init

Default location: ~/.local/share/mindmap/

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com