Skip to content

Fusion-Data-Company/FusionClaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

FusionClaw

All hustle. No luck. One database.

The agent-native business operating system. Bring your own AI agent. Run your own business. CRM, operations, content, finance, marketing — one Postgres database, 234 MCP tools, dark-mode-only.

Next.js TypeScript Tailwind Drizzle License: MIT CI GitHub stars

fusionclaw.app · Docs · Discord · Vision · Contributing


What is FusionClaw?

FusionClaw is a unified business platform built for small business owners and agencies who want one tool instead of ten. It merges CRM, employee ops, content creation, marketing, and bookkeeping into a single Next.js application — and exposes everything through MCP so AI agents like Claude Code can run your business alongside you.

What sets it apart — agent-native from the metal up

Most CRMs added a chat sidebar. FusionClaw is built around a self-improving agent fleet:

  • 🪄 Skill Forge — Type a one-line goal, get a working skill (prompt + eval criteria + seed test cases) in 5 seconds
  • 🧠 Karpathy reflection loop — Every Monday at 6am the worst-performing skill gets analyzed and 3 prompt edits proposed
  • ⚡ Reasoning trace streaming — Watch agents think live; tool calls render as expandable nodes, final output as interactive UI
  • 🎨 Generative UI — Skills return scorecards, email previews, intel cards — not walls of text
  • 🧪 Eval Studio — Per-skill test cases with pass/fail matrix; 80% rate gates promotion to production
  • 👥 Council mode — 3 agents (Sales, Researcher, Closer) debate every deal, then synthesize a verdict
  • 🎙️ Voice agent — Full-duplex via OpenAI Realtime; talk to your CRM, run skills, create tasks
  • 🌐 Browser-using skills — Hand a URL, get back structured intel; ready to swap to Stagehand for full automation
  • 💰 Cost-optimized routing — Thompson sampling bandit picks the cheapest model that hits your eval bar
  • 📚 Wiki memory — The agent's memory layer is a transparent wiki you can read, edit, and curate (no opaque vector DB)
  • 🛒 Skill Marketplace — One-click install of curated templates with seed evals included

Standard business capabilities

  • CRM & Pipeline — 37k+ row TanStack Virtual table with full inline editing, drag-and-drop kanban, complete lead lifecycle
  • Employee Ops — Shift tracking, daily checklists, task management, accountability reports
  • Content Studio — OpenRouter streaming chat, fal.ai image generation, WordPress publishing
  • Marketing — Email campaigns, AI content queue with approval workflow, content calendar
  • Finance — Invoices with line items, expense tracking (10 categories), P&L dashboard with tax estimates
  • MCP Server — 100+ tools exposing the entire platform to MCP-compatible agents with a single API key
  • Webhooks · Workflows · Activity Stream — Inbound webhooks fire skills; outbound webhooks fire on lead/task/skill events; live activity stream shows every run + cost + latency

Quick Start

git clone https://github.com/Fusion-Data-Company/FusionClaw.git
cd FusionClaw
npm install
npm run onboard    # interactive: DB URL, optional API keys, MCP key, optional OWNER_PASSWORD
npm run dev        # http://localhost:3000 — no login required on localhost

What you should see: the landing page at localhost:3000. Click Live Demo → you're routed straight into the app at /dashboard. No signup, no Clerk, no third-party auth. On localhost you're trusted automatically. When you deploy to Vercel or your own server, you set a single OWNER_PASSWORD env var to gate the UI. Agents authenticate with the MCP API key.

The onboard command creates your .env.local, pushes the database schema, generates a secure MCP API key, and optionally generates an OWNER_PASSWORD for deployed instances. Full docs at docs/ — setup, install paths, concepts, MCP reference, modules, security, troubleshooting.

Modules

Module Pages Description
Command Dashboard, Today, Tasks, Employees, Reports Daily operations hub with shift tracking and accountability
Finance Invoices, Expenses, Financials Bookkeeping with P&L charts, tax estimates, overdue alerts
Contacts Leads Database, Pipeline CRM with 37k+ row virtual table and kanban pipeline
Marketing Campaigns, AI Queue, Studio, Gallery, Publishing Content creation and distribution pipeline
System Knowledge Base, Chat, Agents, Cron Jobs, Branding, Settings AI assistant, automation, and platform configuration

MCP Server — 234 Tools

The built-in MCP server gives AI agents complete programmatic access to your business:

{
  "fusionclaw": {
    "command": "node",
    "args": ["./mcp-server/dist/index.js"],
    "env": {
      "MCP_API_KEY": "your-key",
      "DATABASE_URL": "your-db-url"
    }
  }
}
Category Tools Examples
CRUD 208 leads_list, invoices_create, tasks_update, expenses_delete
Query 4 query_custom, query_aggregate, query_raw_sql
Analytics 7 dashboard_metrics, pipeline_summary, revenue_forecast
AI 5 chat_send, image_generate, content_humanize
System 10 settings_get, cron_trigger, health_check

Tech Stack

Layer Technology
Framework Next.js 16 (App Router, Turbopack)
Database Neon PostgreSQL + Drizzle ORM
Styling Tailwind CSS v4 (dark mode only)
Components Radix UI, Framer Motion
Tables TanStack Table v8 + TanStack Virtual
Drag & Drop @hello-pangea/dnd
Charts Recharts
AI Text OpenRouter API (streaming SSE)
AI Images fal.ai (Flux, Nano Banana)
Storage Vercel Blob
Agent Protocol Model Context Protocol SDK
Testing Playwright (47+ E2E and API tests)
Deployment Vercel

Project Structure

app/
  (app)/             23 authenticated pages
  api/               35+ REST API endpoints
components/
  primitives/        GlassCard, base components
  effects/           SpotlightCard, animations
  leads/             TanStack table, pipeline, editable cells
lib/
  actions/           13 server action modules
  db/                Drizzle schema (33 tables)
  validations/       Zod schemas for all mutations
  images/            fal.ai client
  openrouter/        AI prompt templates
mcp-server/          234-tool MCP server (separate build)
tests/               Playwright E2E and API tests
docs/                Setup guide, architecture, MCP reference

Scripts

Command Description
npm run dev Start dev server (Turbopack)
npm run build Production build
npm run onboard Interactive setup wizard
npm run mcp Start MCP server
npm run mcp:build Build MCP server
npm run db:push Push schema to database
npm run db:seed Seed demo data
npm run key:rotate Rotate MCP API key

Documentation

Document Description
Vision Why FusionClaw exists and where it's going
Roadmap What's coming in v1.1 and v1.2
Setup Guide Installation, configuration, deployment
Architecture System design, data flow, schema overview
MCP Tools Reference Complete list of 234 agent tools
Contributing How to contribute, code style, PR process
Changelog Version history and release notes
Security Vulnerability reporting policy

Self-Hosting

# Clone and configure
git clone https://github.com/Fusion-Data-Company/FusionClaw.git
cd FusionClaw
cp .env.example .env.local    # edit with your keys
npm install
npx drizzle-kit push           # create database tables
npm run dev                    # http://localhost:3000

See .env.example for all required environment variables.

Star History

Star History Chart

Contributing

We welcome contributions. Please read our Contributing Guide and Code of Conduct before submitting a PR.

Looking for a place to start? Check out issues labeled good first issue.

Contributors

License

MIT License — free for any use, including commercial. Fork it, ship it, sell it. Just keep the copyright notice.


Built by Fusion Data Company

If this is useful, give it a star. It helps more than you think.

About

All hustle. No luck. One database. Open-source agent-native business OS — bring your own AI agent. CRM, ops, finance, content. 234 MCP tools.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages