🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub✦ BytesAgain

Mindmap

by @bytesagain-lab

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

Versionv2.0.1
Downloads1,654
Installs7
Stars⭐ 2
TERMINAL
clawhub install mindmap

πŸ“– About This Skill


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 [args].

| Command | Description | |---------|-------------| | run | 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 | Add a new dated entry to the data log | | remove | Remove an entry (logs the removal) | | search | 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

  • 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*

    ⚑ When to Use

    TriggerAction
    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"

    βš™οΈ 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*