Maskin

An open-source workspace where AI agents run product development autonomously. Humans set direction, agents execute.

What is this?

• Open-source workspace where AI agents run product development end-to-end
• Core pipeline: Insights (signals from users, data, market) -> Bets (hypotheses to validate) -> Tasks (concrete work items) -> Feedback Loop
• Agents are first-class citizens -- they create insights, propose bets, break down tasks, and execute. Humans course-correct
• Everything is an API -- UI and agents use the same endpoints. No special agent interface, no separate human interface
• Unified object model -- insights, bets, and tasks are all "objects" with the same schema, connected by relationships

Prerequisites

• Node.js ≥ 20
• pnpm 9.15.0 (npm install -g [email protected])
• Docker + Docker Compose — must be installed and running. pnpm dev / pnpm dev:win boot PostgreSQL + SeaweedFS via docker-compose, so the app cannot start without Docker. Docker Desktop (macOS/Windows) bundles Compose; on Linux install docker-compose-plugin.

Quick Start

🚀 Zero-click setup (from Claude Code)

Paste this single prompt into Claude Code (or any MCP-compatible agent) to have it bootstrap the whole thing for you:

Clone https://github.com/sindre-ai/maskin, cd into it, follow the "Onboarding a new user from Claude Code" section of CLAUDE.md, and hand off to the get_started MCP tool.

Claude will clone, pnpm install, start the dev stack in the background, wait for the startup banner, wire the MCP server into your Claude Code config using the auto-provisioned API key + workspace, run /reload-plugins so the Maskin tools are immediately available in the same session, and then ask you which template to set up (development / growth / custom). From clone to a running pipeline in one message, no session restart.

Manual setup

# Clone and install
git clone https://github.com/sindre-ai/maskin.git && cd maskin
pnpm install

# Start everything (Docker + migrations + backend + frontend)
pnpm dev          # macOS / Linux
pnpm dev:win      # Windows (cmd / PowerShell)

pnpm dev boots PostgreSQL + SeaweedFS via Docker, runs migrations, then starts the backend (http://localhost:3000) and frontend (http://localhost:5173). When the backend prints its startup banner, pick one of the two paths below.

① Get started from the browser

1. Open http://localhost:5173 and create an account.
2. Create your first workspace from the UI.
3. (Optional) Connect MCP from Settings → MCP later if you want agents to drive the workspace.

② Get started from Claude Code (no UI)

On a fresh database, pnpm dev automatically creates a default actor + workspace and prints a ready-to-run claude mcp add command in the startup banner — including the API key. Two steps from there:

1. Connect MCP — copy the claude mcp add maskin … line from the dev banner and run it. (Disable this auto-bootstrap with MASKIN_AUTO_BOOTSTRAP=false if you want to create credentials yourself.)

2. Configure the workspace. In Claude Code, paste one of:

   Configure my Maskin workspace with the "development" template.
   

   Configure my Maskin workspace with the "growth" template.
   

   Configure my Maskin workspace with a custom template.
   

   The first two apply pre-built templates (object types, statuses, custom fields, seed objects). The third walks you through a short questionnaire and tailors the workspace to whatever you're working on. Claude will ask a couple of light tailoring questions (workspace name, what you're building, near-term goal) — answer any, all, or none. Total time: under 3 minutes.

Rename the default actor and workspace whenever you're ready — from the UI (Settings → Profile / Workspace) or via MCP (update_actor, update_workspace). Run get_started again any time on a different workspace by passing workspace_id.

Want demo data instead? Run pnpm db:seed for a pre-populated example workspace.

This is the beginning of the README. Read the rest at the original. Read the full README ↗