Storage and State

MindMux stores data in multiple layers, each with a different durability and ownership model.

Durable project knowledge

The brain/ directory stores the project's durable memory:

• root docs
• pages
• brain metadata

This layer is intended to be human-readable and versionable.

Project-local operational state

Project-local storage holds state tied to a specific project instance, such as:

• session logs
• task state
• project-scoped settings

User-global app state

Some settings and secure values live in user-level application storage rather than inside the project. This is the right place for items like auth state, encrypted secrets, or global preferences.

Why the split is important

MindMux makes a strong distinction between:

• what should become part of the project's durable record
• what is only necessary to operate the application locally

That distinction helps teams keep project memory clean and portable.