# MindXFlow — LLM Discoverability File
# https://llmstxt.org

# What is MindXFlow?
MindXFlow is a local-first, fractal mind-mapping web application for complex thinkers.
It lets users organize ideas in an infinite nested canvas where every idea can expand
into its own sub-canvas — a recursive, fractal structure.

# Core Concepts
- **Cell**: The atomic unit. Has a title, rich HTML content, and optional version history.
- **Grid**: A canvas containing a center cell surrounded by connected idea cells.
- **Root grid**: The top-level canvas (ID: "root"). All maps start here.
- **Sub-canvas**: When a cell is "expanded", it becomes the center of its own grid.
- **Path notation**: `1` = root, `1.2` = second child of root, `1.2.3` = its third child.

# Data Model (JSON)
```json
{
  "grids": {
    "root": [
      { "id": "root", "title": "Core Idea", "content": "", "x": 0, "y": 0 },
      { "id": "cell-abc", "title": "Branch 1", "content": "<p>Details</p>", "x": 320, "y": 0 }
    ],
    "cell-abc": [
      { "id": "cell-abc", "title": "Branch 1", "content": "", "x": 0, "y": 0 },
      { "id": "cell-xyz", "title": "Sub-idea", "content": "", "x": 320, "y": 0 }
    ]
  },
  "structureVersion": 5
}
```

# Views
- **Canvas (GridView)**: Freeform draggable fractal canvas. Default view.
- **Tree**: Hierarchical tree layout of the entire map.
- **Mind Map**: Radial mind map layout.
- **Fishbone**: Cause-and-effect Ishikawa diagram.
- **Outline (Linearmap)**: Linear text outline.
- **Notepad**: Full rich-text editor for a single cell.
- **Mobile Capture**: Simplified quick-entry interface for mobile.

# Storage
- Browser: IndexedDB (`mindXflow_DB`) — persistent, local-only.
- MCP bridge: `mindxflow-state.json` — machine-readable state file (when MCP server is running).

# AI/MCP Access
MindXFlow exposes an MCP (Model Context Protocol) server for AI agent access.
Run: `node mcp-server/dist/index.js`
MCP tools: get_map, get_cell, add_idea, update_idea, delete_idea, search_ideas, export_markdown
REST bridge: http://localhost:3747 — endpoints: GET /api/state, POST /api/sync, GET /api/health

# Key Features
- Fractal infinite canvas — every idea can have its own sub-canvas
- Wiki-style [[linking]] between ideas
- Rich text editor with Markdown export
- Version history (last 3 snapshots with timestamps)
- Undo/redo support
- Multiple visualization modes
- Local-first — all data stays on device
- Dark mode support
- Full keyboard shortcuts (Cmd+K search, Cmd+Z undo, Cmd+Shift+Z redo)

# Source
GitHub: https://github.com/mindxflow/mindxflow (example)
License: MIT