Flowzen (Blaue Rose)

A circadian scheduling layer for agents.

Agent systems usually run flat out or not at all. Flowzen gives them a rhythm: it watches what the user is actually doing, keeps a rolling picture of the current state, and lets agents adapt their pace to it instead of interrupting at the worst possible moment. The model is biological — attention rises and falls over a day, and work should follow that curve rather than fight it.

Passive by design. Flowzen observes and advises; it does not schedule anything itself.

Components

File	Role
activity_tracker.py	rolling observation of user activity
brain_bridge.py	hands the current state to the VibeMind brain for routing decisions
config.py	FlowzenConfig, read from the environment
agents/flowzen_agent.py	the agent that answers "what is a good time for this?"
tools/flowzen_tools.py	tools exposed to other agents

Configuration

Off unless explicitly enabled.

Variable	Default	Meaning
FLOWZEN_ENABLED	false	master switch
FLOWZEN_SUMMARY_INTERVAL	30	minutes between activity summaries

from flowzen.config import FlowzenConfig

config = FlowzenConfig.from_env()

Status

Early and small — a working sketch of the idea rather than a finished scheduler. It runs as the flowzen space inside VibeMind and is published separately because the idea stands on its own.

License

MIT — see LICENSE.