Sandbox
@text2future/flowix

MCP memory for Flowix notes and agents

Flowix turns Markdown notes into shared working memory for agents. You keep context in local files, then connect that context to Codex, Claude Code, OpenCode, or a Harness agent through the bundled MCP and CLI pieces.

408 stars52 forksTypeScriptUpdated 6d ago
Who it's for

Builders who want their agents to reuse local notes, research, and task context instead of starting over.

What it delivers

You can keep one local source of truth for notes and let agents read, update, and reuse it across sessions.

What it does

Markdown notebook storage

Keeps notes as plain Markdown files you can open and edit outside Flowix.

Agent memory workflow

Lets you pass chosen notes or folders to an agent, then write the result back into the same note.

Multi-agent access

Connects Codex, Claude Code, OpenCode, Hermes, and other MCP or CLI tools to the same memory.

DeepSeek Harness plugin

Provides `dsh-flowix-memory` so Harness agents can search, read, create, and edit memos through the Flowix MCP server.

Local control and sync

Keeps notes on your device and lets you choose how to sync, back up, or version them.

How to get it

  1. 1Install it into the flowix Harness profile from the flowix-main checkout (not yet…
    dsh plugin --profile flowix add ./dsh-flowix-memory
  2. 2Use a UTF-8 file as the recommended way to pass Markdown content to create and write,…
    flowix create <notebook> --file body.md --json
    flowix write <id> --file body.md --json
  3. 3On Windows, stdin is no longer read implicitly when neither input option is given,…
    $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
    Get-Content -Raw -Encoding UTF8 body.md | flowix create <notebook> --stdin --json
  4. 4Call an agent from within the document, or keep organizing content with tags and…
    git clone https://github.com/text2future/flowix.git
    cd flowix
    npm install
    
    npm run tauri dev
    npm run dev
    npm run tauri build

README

English | 简体中文

Flowix

Notes for you,
Memory for your agents.

The Markdown notebook where your words seamlessly become durable context for AI agents.

Markdown · Open Source · Multi Agent · MCP & CLI

Download · Website · Docs


Flowix

Flowix turns notes into working memory

Write in Markdown, point an agent to the context it needs, and save the result back to the same note — ready to review, edit, and reuse next time.

Flowix notes shown across light and dark themes

Keep work moving

Keep product work, development, research, and personal knowledge together, so agents can continue without starting over.

Use caseWhat it does
Product workKeep requirements, feedback, decisions, and PRDs up to date.
Software developmentGive coding agents the context to continue your project.
ResearchKeep sources, analysis, and conclusions together and reusable.
Personal knowledgeTurn notes, plans, and preferences into useful agent context.

Flowix navigation for notes, conversations, tasks, and tags


Connect every agent to the same memory

Use agents inside Flowix or connect Codex, Claude Code, OpenCode, Hermes, and other MCP or CLI tools — all working from the same notes and context.

Flowix connecting Codex, Claude Code, OpenCode, Hermes, and Flowix Agent to the same note


dsh-flowix-memory plugin

dsh-flowix-memory is a DeepSeek Harness plugin that connects any Harness agent to your local Flowix notes through the bundled flowix-cli MCP server: the agent gets the mcp__flowix__memo tool to search, read, create, and edit Flowix memos (including mind maps).

Install it into the flowix Harness profile from the flowix-main checkout (not yet published to npm). In other DSH clients, flowix is an ordinary custom profile name:

dsh plugin --profile flowix add ./dsh-flowix-memory

Requires the flowix CLI on PATH (or set FLOWIX_CLI_PATH) with access to your notebook data (~/.flowix). See the plugin README for details.

Passing Markdown to the CLI

Use a UTF-8 file as the recommended way to pass Markdown content to create and write, especially from Windows PowerShell 5.1. This avoids text being damaged by stdin pipeline encoding. UTF-8 files may include a BOM, and files without a BOM are supported too.

flowix create <notebook> --file body.md --json
flowix write <id> --file body.md --json

On Windows, stdin is no longer read implicitly when neither input option is given, preventing PowerShell 5.1's $OutputEncoding from corrupting non-ASCII text. If the caller has guaranteed UTF-8 stdin, opt in explicitly:

$OutputEncoding = [System.Text.UTF8Encoding]::new($false)
Get-Content -Raw -Encoding UTF8 body.md | flowix create <notebook> --stdin --json

--file and --stdin are mutually exclusive. The --file path is read directly as UTF-8; a missing, unreadable, or invalid UTF-8 file returns an error. With --json, errors use the stable {ok:false,error:{code,message}} shape.


Your notes stay local and under your control

Flowix keeps your work as plain Markdown files on your device. You choose what agents can access, when context is sent, and how your files are synced, backed up, or versioned.

  • Files you can open anywhere — Your notes are saved as plain Markdown on your device, so you can read and edit them with other apps.
  • Agents see only what you choose — Share a single note, a folder, or a whole notebook — only when you want an agent to use it.
  • Use the agents you already trust — Connect Codex, Claude Code, OpenCode, or another external agent. Flowix shares only the context you choose, when you start a task.
  • Sync and back up your way — Use the sync, backup, or version-control tools you already trust. There's nothing to export.

Product preview

Note library with tags
Note library with tags
Note detail with agent presets
Note detail with agent presets
Agent model picker
Agent model picker
Full-text and file search
Full-text and file search
Provider and MCP configuration
Provider and MCP configuration
Code file browsing and editing
Code file browsing and editing

Quick start

  1. Download and install Flowix from the website.
  2. Create a new local folder, or register an existing folder as a notebook.
  3. Create a document and write down the task background, reference materials, goals and constraints.
  4. Call an agent from within the document, or keep organizing content with tags and properties.

Local development

git clone https://github.com/text2future/flowix.git
cd flowix
npm install

npm run tauri dev
npm run dev
npm run tauri build

The development environment requires Node.js 20+, Rust 1.75+ and Tauri v2; the desktop app supports macOS 14+ and Windows 10+.

License

Flowix is open source under the MIT License.

Files in the repo

Repository payload24 top-level entries
  • .github
  • app
  • docs
  • dsh
  • dsh-appserver
  • dsh-flowix-memory
  • examples
  • scripts
  • .gitattributes
  • .gitignore
  • CLAUDE.md
  • CONTRIBUTING.md
  • lefthook.yml
  • LICENSE
  • package-lock.json
  • package.json
  • postcss.config.js
  • README.md
  • README.zh-CN.md
  • tailwind.config.js
  • tsconfig.json
  • tsconfig.node.json
  • vite.config.ts
  • vitest.config.ts

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface

86k

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
tirth8205/
code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k
2akouwu/
reverify

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k