Install

You can adopt the whole framework, one layer, or one kit inside a layer. Install only what you will use.

Get the repository and run the checks


git clone <the repository> mentura
cd mentura && node test.mjs

You need Node 20 or later, and python3 with the jsonschema package.

Start a venture


node interface/cli/mentura.mjs init ~/ventures/my-venture --id my-venture --layers purpose
export MENTURA_WORKSPACE=~/ventures

Leave out --layers to use the phase’s default layers. A layer you leave off is written as false, and the need-now score marks its records as “layer off” instead of suggesting them.

Connect your agent harness

Claude Code


claude mcp add mentura --env MENTURA_WORKSPACE=$HOME/ventures --env MENTURA_HARNESS="Claude Code" -- node /path/to/mentura/interface/mcp/server.mjs

Cursor

.cursor/mcp.json


{
  "mcpServers": {
    "mentura": {
      "command": "node",
      "args": ["/path/to/mentura/interface/mcp/server.mjs"],
      "env": { "MENTURA_WORKSPACE": "/path/to/ventures", "MENTURA_HARNESS": "Cursor" }
    }
  }
}

CLI or script


node interface/cli/mentura.mjs help
node interface/api/server.mjs   # local only: 127.0.0.1:4330, no authentication

Check the connection

Ask the agent to call mentura_ventures, then mentura_view on system/overview.