Skip to main content

Quick Start

Get maenifold running in minutes.

Installation

Install maenifold globally using npm:

npm install -g @ma-collective/maenifold

MCP Interface

Claude Code, Continue, Cline

Add maenifold to your MCP configuration:

{
  "mcpServers": {
    "maenifold": {
      "command": "maenifold",
      "args": ["--mcp"],
      "env": {"MAENIFOLD_ROOT": "~/maenifold"}
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.maenifold]
type = "stdio"
command = "maenifold"
args = ["--mcp"]
startup_timeout_sec = 120
tool_timeout_sec = 600
env = { MAENIFOLD_ROOT = "~/maenifold" }

Try it out by asking: "Write a memory about our architecture decisions"

CLI Interface

Use maenifold directly in scripts, pipelines, or with non-MCP clients:

Write a memory with WikiLinks

maenifold --tool WriteMemory --payload '{
  "title": "Architecture Decisions",
  "content": "Our [[microservices]] use [[event-sourcing]] for [[audit-trails]]"
}'

Continue a sequential thinking session

maenifold --tool SequentialThinking --payload '{
  "sessionId": "session-1234567890",
  "response": "After analyzing the architecture...",
  "nextThoughtNeeded": true
}'

Search memories with hybrid mode

maenifold --tool SearchMemories --payload '{
  "query": "authentication patterns",
  "mode": "Hybrid",
  "pageSize": 10
}'

Full Feature Parity

MCP and CLI have full feature parity. Start a session via MCP and continue it via CLI, or vice versa. The system supports concurrent agents using the same memory location — perfect for multi-agent pipelines or parallel workflows.

Proven Use Cases

Four patterns for integrating maenifold into your workflow—from knowledge building to multi-agent orchestration:

Next Steps