fluct-local

Local, single-user, no-cloud edition of Fluct. Everything runs on your machine: SQLite at ~/.fluct/db.sqlite, the web UI on localhost:3737, and an MCP server that Claude Code spawns as a stdio subprocess. No accounts, no Supabase, no Vercel.

Built for environments where Claude Enterprise blocks custom remote connectors but local stdio MCP servers are still allowed.

Install + run (3 lines)

npm install -g fluct-local
fluct-local start
claude mcp add --transport stdio fluct-local -- fluct-local mcp

That's it. The first start automatically creates ~/.fluct/db.sqlite and applies the schema — no separate init step needed. Open http://localhost:3737, create a map in the UI, and Claude Code will see it through 56 MCP tools (get_service_map, create_product, create_memory, snapshot tools, scenario tools, and more).

What's in the DB

~/.fluct/db.sqlite holds everything: maps, nodes, edges, scenarios, permissions, memories, snapshots, comments, audit history. The file never leaves your machine.

To inspect manually:

sqlite3 ~/.fluct/db.sqlite '.tables'

To start fresh, delete the file and re-run fluct-local init.

What's stripped vs the cloud edition

This package is a fork of the cloud Fluct, with everything that has no meaning in a single-user local context removed:

• Supabase auth, login/signup/share routes, OAuth flow
• Organizations, members, invites, profiles
• API keys, OAuth tokens
• Watcher / notification system
• Vercel deploy configuration

The map editor, memory map, scenarios, permission labels, snapshots, and the full MCP tool set are preserved.

Environment variables

| Variable | Purpose | | --------------- | ------------------------------------------------------------------------- | | FLUCT_DB_PATH | Override the SQLite location (default ~/.fluct/db.sqlite) | | FLUCT_MAP_ID | Pin the active map for fluct-local mcp (default: most recently updated) | | PORT | Override the web UI port (default 3737) |

CLI reference

fluct-local start          Boot the web UI on http://localhost:3737
fluct-local mcp            Run the stdio MCP server (target of `claude mcp add`)
fluct-local init           Create ~/.fluct/db.sqlite and apply the schema
fluct-local --help         Print this list

Develop from source

git clone <this repo>
cd fluct-local
npm install
npm run init               # apply schema to ~/.fluct/db.sqlite
npm run dev                # next dev on :3737, hot reload
npm run mcp                # run stdio MCP from source via tsx
npm run build              # produce dist/bin + .next/standalone for publish

License

MIT