MindrianOS

INSTALL

Two commands. Zero configuration. Larry starts talking immediately.

New Here? Follow the Step-by-Step Guide

No technical experience required. 10 minutes from zero to Larry.

Open Install Guide →
Terminal
# Option A: One-line install (works everywhere) curl -sL https://raw.githubusercontent.com/jsagir/mindrian-os-plugin/main/install.sh | bash # Option B: Plugin marketplace (if available) claude plugin marketplace add jsagir/mindrian-marketplace claude plugin install mos@mindrian-marketplace

View on GitHub →

CHOOSE YOUR SURFACE

MindrianOS runs on all three Claude surfaces. Each has different strengths.

Claude Code (Recommended)

The full power experience. Hooks fire automatically, scripts execute, the Data Room updates in real-time. This is where MindrianOS was built to live.

01

Install the plugin

# Option A: One-line install (works everywhere) curl -sL https://raw.githubusercontent.com/jsagir/mindrian-os-plugin/main/install.sh | bash # Option B: Plugin marketplace (if available) claude plugin marketplace add jsagir/mindrian-marketplace claude plugin install mos@mindrian-marketplace
02

Start a new project

/mos:new-project

Larry creates your Data Room with 10 sections and initial STATE.md

03

Talk to Larry about your venture

Larry classifies your problem type silently and guides you to the right frameworks. Insights auto-file into the Data Room.

04

Run methodology commands as you go

/mos:explore-domains # Map the innovation landscape /mos:challenge-assumptions # Stress-test before the market does /mos:build-thesis # Craft your investment thesis
05

Export when ready

/mos:export --type thesis # Investment thesis PDF /mos:room view # Knowledge graph dashboard

What you get on Claude Code

SessionStart hooksAuto-filing on every writeScript executionPDF exportDashboard serverPipeline chainingContext monitoringFull 66 commands

Claude Desktop

Conversational experience. Larry's personality shines brightest here. Less command-driven, more natural dialogue. Great for exploring ideas before committing to a project structure.

01

Install the plugin (same command)

Open Claude Desktop settings, navigate to Plugins, and install via the terminal command above.

02

Start a conversation with Larry

You: I've been thinking about patient handoffs between shifts losing critical information.

Larry: Before we jump to solutions -- when you say "critical information," are you talking about clinical data that exists in the EHR but doesn't transfer, or tacit knowledge that lives in the nurse's head?

03

Discover commands through conversation

Type /mos:help and Larry recommends what to work on next based on your room state.

Best for

Early-stage explorationNatural conversationLarry's personalityQuick ideation sessions

Limitations vs Claude Code

Hooks are CLI-only, but intelligence cascade fires via MCP. Dashboard, wiki, and graph render inline via MCP Apps.

Cowork

Multi-user, persistent agents. Your team shares a Data Room through the 00_Context/ directory. Everyone sees what Larry sees. Export quality maintained for investor presentations.

01

Install the plugin in your workspace

Same install command. The plugin activates for all workspace members.

02

Create a shared project

/mos:new-project creates the room structure. All team members can view and contribute to the Data Room.

03

Collaborate through the shared room

Multiple team members can run methodology commands concurrently. Insights from different perspectives merge into the same Data Room.

Best for

Team venturesShared Data RoomConcurrent methodologyInvestor presentations

YOUR FIRST 5 COMMANDS

After installing, try these in order. Each builds on the last.

01
/mos:new-project

Creates your venture Data Room with 10 sections

02
/mos:beautiful-question

Reframes your challenge into a question worth investigating

03
/mos:explore-domains

Maps the innovation landscape around your problem

04
/mos:challenge-assumptions

Stress-tests your thinking before you invest further

05
/mos:status

Shows your Data Room state and suggests what to do next

ALL 66 COMMANDS

Every command framed as the job it gets done: "When [situation], you want [progress], so you can [outcome]."

AllGetting StartedProblemMarketChallengeSolutionIntelligenceParallelExport
CommandWhen you... you want... so you can...Status
Getting Started
/mos:new-projectWhen starting fresh, want a structured Room, so you capture insights from day oneLive
/mos:onboardWhen just installed, want a guided walkthrough, so you're productive immediatelyLive
/mos:helpWhen unsure which command fits, want Larry's recommendation based on Room stateLive
/mos:statusWhen checking venture health, want a dashboard of gaps and signals, so you decide what's nextLive
/mos:setupWhen wanting deeper intelligence, want guided Brain/Velma connection in one stepLive
/mos:updateWhen new version exists, want JTBD-framed changelog, so you know why you should careLive
/mos:splashWhen confirming plugin is active, want the Mondrian banner and versionLive
Room Management
/mos:roomWhen browsing your Data Room, want section detail and filing optionsLive
/mos:roomsWhen working multiple ventures, want to switch Rooms without losing contextLive
/mos:queryWhen you have a question about your data, want plain-language graph queriesLive
/mos:wikiWhen exploring connections, want Wikipedia-style viewer with hyperlinksLive
/mos:graphWhen wanting raw graph access, want direct KuzuDB explorationLive
Defining the Problem
/mos:beautiful-questionWhen problem feels vague, want a provocative reframing that opens new directionsLive
/mos:explore-domainsWhen unsure which domain, want to map the innovation landscapeLive
/mos:map-unknownsWhen suspecting hidden blind spots, want structured inventory of unknownsLive
/mos:diagnoseWhen venture is stuck, want problem classification (wicked/complex/simple)Live
/mos:root-causeWhen treating symptoms, want backward tracing to fix the sourceLive
/mos:build-knowledgeWhen needing depth, want structured knowledge building with evidenceLive
Understanding the Market
/mos:analyze-needsWhen unsure what job customers hire for, want to discover the struggling momentLive
/mos:explore-trendsWhen wanting market direction, want trend analysis showing direction and speedLive
/mos:analyze-timingWhen unsure if now is the moment, want timing analysis (why now, what changed)Live
/mos:macro-trendsWhen needing big-picture forces, want PESTLE-level analysisLive
/mos:user-needsWhen understanding user journeys, want process-level friction analysisLive
/mos:explore-futuresWhen preparing for multiple outcomes, want scenario explorationLive
Challenging Your Thinking
/mos:challenge-assumptionsWhen claims are untested, want to find which assumptions are load-bearing vs wishfulLive
/mos:validateWhen thesis lacks proof, want evidence-based validation of core claimsLive
/mos:find-bottlenecksWhen progress feels slow, want to identify the one constraint blocking everythingLive
/mos:dominant-designsWhen seeking whitespace, want to map dominant designs and find differentiationLive
/mos:think-hatsWhen stuck in one perspective, want 6 structured viewpoints (De Bono)Live
Building Your Solution
/mos:structure-argumentWhen thinking is scattered, want a Minto Pyramid, so you explain your thesis in 60 secondsLive
/mos:scenario-planWhen facing multiple paths, want structured scenario analysis with decision criteriaLive
/mos:analyze-systemsWhen understanding interactions, want systems decomposition showing interfacesLive
/mos:systems-thinkingWhen wanting dynamic forces, want loop diagrams to find leverage pointsLive
/mos:lean-canvasWhen needing a business model, want Lean Canvas filled from Room dataLive
/mos:leadershipWhen building a team, want leadership framework matched to venture stageLive
Evaluating Your Venture
/mos:gradeWhen unsure how strong your work is, want honest assessment vs 100+ real projectsLive
/mos:build-thesisWhen articulating why this matters, want a structured investment thesis from evidenceLive
/mos:score-innovationWhen wanting calibration, want scored assessment on novelty, feasibility, fitLive
Intelligence + Discovery
/mos:find-analogiesWhen stuck on a 'unique' problem, want cross-domain structural matches from other industriesv1.6.0
/mos:find-connectionsWhen wanting cross-domain links, want Brain pattern discovery across 32K+ nodesBrain
/mos:compare-venturesWhen wanting to learn from others, want anonymized pattern matching from 100+ venturesBrain
/mos:researchWhen needing external evidence, want web research cross-referenced with Room dataLive
/mos:reasonWhen Section needs rigorous argument, want Minto/MECE with dependency trackingLive
/mos:scoutWhen Room hasn't been health-checked, want full sentinel scan (health, grants, competitors)v1.6.0
/mos:radarWhen wanting new capabilities, want a scan of what's availableLive
Meetings + People
/mos:file-meetingWhen insights are about to evaporate, want automatic speaker ID and section filingLive
/mos:personaWhen thinking from one angle, want 6 AI expert perspectives (De Bono hats)Live
/mos:persona --parallelWhen needing perspectives fast, want all 6 hats simultaneously in 2 minutesv1.6.0
/mos:speakersWhen reviewing contributions, want speaker profiles with key insights per personLive
/mos:reanalyzeWhen new context changes interpretation, want re-run on past meetingsLive
Funding + Opportunities
/mos:opportunitiesWhen haven't explored non-dilutive funding, want grants matched to domain and stageLive
/mos:fundingWhen pursuing funding, want lifecycle tracking so you never miss a deadlineLive
Parallel Powernew in v1.6.0
/mos:act --swarmWhen 3+ Sections have gaps and only 30 min, want all filled at once. 5 min instead of 45v1.6.0
/mos:grade --fullWhen needing comprehensive assessment, want all 8 Sections graded in parallelv1.6.0
/mos:research --broadWhen needing multi-angle intelligence, want 3 parallel research agentsv1.6.0
/mos:modelsWhen burning tokens, want per-agent model control. Opus for teaching, Haiku for scanningv1.6.0
Autonomous + Brain
/mos:actWhen wanting Larry to pick the right framework, want autonomous selection by problem typeLive
/mos:act --chainWhen needing a framework sequence, want 3-5 chained where each feeds the nextLive
/mos:suggest-nextWhen unsure what to work on, want Brain-informed next step from 100+ venturesBrain
/mos:deep-gradeWhen wanting calibrated assessment, want grading with percentile ranking vs real projectsBrain
Export + Sharing
/mos:exportWhen sharing professionally, want generated reports (thesis, summary, due diligence)Live
/mos:snapshotWhen sharing Room intelligence, want 7-view interactive HTML hub anyone can openv6.2
/mos:presentWhen wanting presentation built and opened, want one command from Room to outputLive
/mos:publishWhen wanting Data Room live on web, want one-click Vercel deployLive
/mos:dashboardWhen wanting interactive graph with chat, want browser launch for visual explorationLive
/mos:pipelineWhen chaining frameworks, want multi-step execution where each output feeds the nextLive
Live
Powerhouse v1.6.0
Requires Brain
RoomHub v6.2

66 commands across 9 MCP routers. All commands work without Brain. Brain-powered commands work at reduced intelligence without a key.

OPTIONAL: CONNECT THE BRAIN

Everything works without the Brain. The Brain makes it smarter.

When you're ready
/mos:setup

The setup command walks you through connecting the Brain (32K+-node knowledge graph). This unlocks 5 additional Brain-powered commands: suggest-next, find-connections, compare-ventures, deep-grade, and research.

PRO TIP: USE INSIDE AN IDE

The Data Room experience is dramatically better when you can SEE it.

Open your project folder in Cursor or VS Code, then run claude in the integrated terminal.

Your entire room/ directory tree appears in the file explorer sidebar. As Larry writes artifacts, they appear in real-time. Click any file to read or edit it while Larry continues in the terminal below.

File explorer shows room/ sections as live folders
Artifacts appear in real-time as Larry files them
Edit any room artifact in the main editor panel
All hooks fire normally (SessionStart, PostToolUse)
With the Claude Code extension: @-mention files to send to Larry

RESOURCES

GitHub

Source code, issues, and contributions.

github.com/jsagir/mindrian-os-plugin

Marketplace

The Claude plugin marketplace listing.

github.com/jsagir/mindrian-marketplace

Architecture Paper

The architecture behind the plugin.

Van Clief & McDermott (2026). arXiv:2603.16021v2

NEXT STEPS

Understand the methodology/how-it-worksCompare tiers/pricingConnect the Brain/brain-accessJoin the community/community