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 <command> [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 INLINECODE22
• 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. 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

CODEBLOCK0

Output

All command output goes to stdout. Redirect to save:

CODEBLOCK1

Configuration

Set the MINDMAP_DIR environment variable to change the data directory:

CODEBLOCK2

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