flux-brain

Store persistent context and reasoning across Flux sessions.

7|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/Nairon-AI/flux --skill flux-brain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flux-brain
Source: https://github.com/Nairon-AI/flux/tree/main/skills/flux-brain
Command: npx skills add https://github.com/Nairon-AI/flux --skill flux-brain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Persistent memory across sessions enables the Flux agent to recall rules, context, and decisions between runs and sessions, improving continuity and reducing repetitive setup.

Core Features & Use Cases

  • Brain files live in .flux/brain/.
  • Remember flow supports routing decisions between CLAUDE.md and the brain vault, with optional external memory integration for cross-repo context.
  • Provides guidance to decide when to store in CLAUDE.md vs the brain vault, and how to confirm with the user before writing.

Quick Start

Tell me to remember X and store it in either CLAUDE.md or the brain vault.

Frequently Asked Questions about flux-brain

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist context and memory across Flux sessions?

To persist context across Flux sessions, store rules in CLAUDE.md and deeper context in the .flux/brain/ vault. Tell the agent to remember specific information, and it will route the data to the correct location for future recall.

What is the difference between CLAUDE.md and the brain vault for context management?

CLAUDE.md stores project rules, while the .flux/brain/ vault holds deeper context and reasoning. The skill provides routing logic to decide where to store information and prompts for user confirmation before writing.

Can I use external memory for cross-project context in Flux?

Yes, you can configure optional external memory to store cross-project context. This extends the standard CLAUDE.md and .flux/brain/ routing to satisfy needs that span across multiple repositories.

How do I tell the Flux agent to remember a specific decision?

Simply tell the agent to remember the decision. The skill applies memory-check and confirmation prompts to verify the action before routing the context to either CLAUDE.md, the brain vault, or external memory.

When should I use external memory instead of local brain files?

Use optional external memory when you need to recall context across multiple different projects or repositories. For single-project rules and reasoning, local CLAUDE.md and .flux/brain/ files are sufficient.