MindMap

---

name: MindMap

description: "Create and visualize mind maps in the terminal with branching and export. Use when brainstorming ideas, organizing thoughts, exporting mind map structures."

version: "2.0.0"

author: "BytesAgain"

homepage: https://bytesagain.com

source: https://github.com/bytesagain/ai-skills

tags: ["mindmap","brainstorm","ideas","organize","thinking","productivity"]

---

# 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]`.

| Command | Description |

|---------|-------------|

| `run <args>` | Execute the main function — logs and confirms execution |

| `config` | Show the configuration file path (`$DATA_DIR/config.json`) |

| `status` | Show current status (reports "ready") |

| `init` | Initialize the data directory (creates `$DATA_DIR` if needed) |

| `list` | List all data entries from the data log |

| `add <text>` | Add a new dated entry to the data log |

| `remove <item>` | Remove an entry (logs the removal) |

| `search <term>` | Search the data log for a keyword (case-insensitive via `grep -i`) |

| `export` | Export all data from the data log to stdout |

| `info` | Show version and data directory path |

| `help` | Show the built-in help message |

| `version` | Print version string (`mindmap v2.0.0`) |

Data Storage

Requirements

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*