flowmind

🧠 FlowMind

The AI Agent That Learns How You Work

Memory and workflow automation for MCP, Codex, and Claude Code.

中文 | Quick Start | Demo | Detailed Guide | Upgrade Contracts | Integration | Changelog

Weekly downloads: 3,280

What It Is

FlowMind is a memory layer for repeatable developer workflows.

Use it when you already have tools and want a better execution surface:

• Route recurring tasks through reusable skills
• Capture explicit feedback and reuse it later
• Run the same workflow from CLI, Codex, or MCP clients
• Audit and change microservice governance across Alibaba Cloud, Huawei Cloud, and Baidu Cloud through guarded workflows

Best-fit use cases today:

• Log and trace investigation
• Code review with fixed standards
• Data validation and internal tool orchestration

Strong Features

• Reusable skill routing turns repeated work into one-command workflows instead of prompt rewrites
• Guarded workflow execution adds dry-run review, approval tokens, and resumable follow-up chains
• Multi-cloud service governance supports audit, diagnosis, and policy changes with provider-aware rollback previews
• Local workflow history preserves execution state so interrupted chains can be resumed instead of restarted
• MCP exposure keeps FlowMind usable from CLI, Codex, and other integrated clients

Quick Start

npm install -g flowmind
flowmind doctor
flowmind skills
flowmind process --skill log-audit "query the latest error logs"

If you want Codex-friendly JSON output:

flowmind-codex skills
flowmind-codex --skill log-audit "查询 traceId abc123 的日志"

If you prefer npx:

npx flowmind@latest doctor
npx flowmind@latest skills

Local State

FlowMind stores local config and learning data under FLOWMIND_HOME/.flowmind. If FLOWMIND_HOME is not set, it falls back to your home directory.

To import local SDD-Agent resources and scene mappings, run:

flowmind resource --sync-sdd-agent

To inspect the currently learned skill feedback and local material packages:

flowmind learn --assets
flowmind learn --assets --skill log-audit --limit 20 --json

MCP clients can use flowmind_learning_assets for the same sanitized, read-only view.

For safety, cross-workspace auto-sync is disabled by default. Initialization only auto-syncs when you explicitly set FLOWMIND_ENABLE_SDD_AGENT_AUTO_SYNC=1.

Why It Works

• Skills provide a stable execution path instead of ad hoc prompts
• Feedback becomes reusable state instead of chat history
• CLI and MCP entrypoints make the workflow scriptable

A Real Example

flowmind process --skill log-audit "查询 traceId abc123 的日志"
flowmind "下次用表格格式"

On the next similar request, FlowMind can reuse that explicit formatting preference from local learning data.

Read By Goal

• Need the full product walkthrough: docs/guide.md
• Need the upgraded skill contracts and chaining patterns: docs/upgrade-contracts.md
• Need Claude Code, Codex, Cursor, or MCP setup: docs/integration-guide.md
• Want to see terminal output first: demo/DEMO.md
• Want release history: CHANGELOG.md

Why This Homepage Is Short

The npm package page works best as an entry page, not as the entire manual. Detailed usage modes, system explanation, and architecture notes now live in the linked docs.

Release Notes

Package release details are maintained outside the published README.

Contributing

PRs are welcome. Start with CONTRIBUTING.md.

License

MIT. See LICENSE.