Installation

Get Fulcrum running in your project in under 2 minutes

Prerequisites

Before installing Fulcrum, make sure you have:

Requirement	Minimum Version	Check Command
Node.js	14.0 or higher	`node --version`
npm	6.0 or higher	`npm --version`
AI Assistant	One of the supported vendors	—

Supported AI Vendors

Fulcrum works with any of these AI coding assistants:

Claude Code — Anthropic's CLI assistant
Cursor — AI-powered code editor
Windsurf — Codeium's AI IDE
Gemini CLI — Google's command-line AI
GitHub Copilot — GitHub's AI pair programmer

💡 Vendor-agnostic: Fulcrum installs the same way regardless of which AI assistant you use. Your skills and workflows are portable between vendors.

Quick Install

Run this single command in your project root:

npm install github:dois-one/fulcrum --save-dev --foreground-scripts

The --foreground-scripts flag is important—it runs the interactive setup wizard that configures Fulcrum for your project.

📝 Why dev dependency? Fulcrum enhances your development workflow but doesn't ship to production. Installing as a dev dependency keeps your production bundle clean.

Interactive Setup

After installation, the setup wizard will ask you a few questions:

1. Choose Your Preset

Select which agents to install based on your project type:

Preset	Agents Included	Best For
`all`	All 13 agents	Full-featured projects, trying everything
`core`	Orchestrator, Reviewer, Tester, Docs	Minimal setup, any project type
`fullstack`	Core + Frontend, Backend, Database	Web applications
`backend`	Core + Backend, Database, Security	APIs, microservices
`frontend`	Core + Frontend, Architect	UI libraries, design systems
`ai`	Core + ML, Backend, Database	ML/AI applications
`devops`	Core + DevOps, Security	Infrastructure, CI/CD
`firmware`	Core + Firmware, Tester	Embedded systems, IoT

⚠️ Recommendation: Start with core or your specific preset. You can always add more agents later with npx fulcrum add @agent-name.

2. Configure AI Vendor

The wizard detects which AI assistants you have installed and configures Fulcrum for each one. If you use multiple vendors, Fulcrum creates configs for all of them.

3. Initialize Memory Bank

Choose whether to initialize the Memory Bank—Fulcrum's persistent context system. We recommend "Yes" for most projects.

Directory Structure

After installation, Fulcrum creates the following structure in your project:

your-project/
├── .fulcrum/
│   ├── skills/           # Agent skill definitions
│   │   ├── orchestrator.md
│   │   ├── frontend.md
│   │   ├── backend.md
│   │   └── ...
│   ├── memory/           # Memory Bank storage
│   │   ├── decisions.md
│   │   ├── patterns.md
│   │   └── context.md
│   └── config.json       # Fulcrum configuration
├── .claude/              # Claude-specific rules (if detected)
├── .cursor/              # Cursor-specific rules (if detected)
└── .windsurf/            # Windsurf-specific rules (if detected)

💡 Version control: Commit the .fulcrum/ directory to your repo. This ensures your team shares the same agent configuration and Memory Bank.

Verify Installation

Open your AI assistant and run:

/status

You should see a list of active agents and their status. If everything is green, you're ready to go.

Manual Installation

If you prefer manual control, you can skip the interactive setup:

# Install without running postinstall script
npm install github:dois-one/fulcrum --save-dev --ignore-scripts

# Run setup manually with specific options
npx fulcrum init --preset=fullstack --vendor=claude

Available CLI Options

Flag	Description	Example
`--preset`	Agent preset to install	`--preset=backend`
`--vendor`	Target AI vendor	`--vendor=cursor`
`--no-memory`	Skip Memory Bank setup	`--no-memory`
`--force`	Overwrite existing config	`--force`

Troubleshooting

npm install fails with permission error

Try running with sudo (macOS/Linux) or as Administrator (Windows):

sudo npm install github:dois-one/fulcrum --save-dev --foreground-scripts

AI assistant doesn't recognize Fulcrum commands

Restart your AI assistant after installation. Some tools cache their configuration and need a fresh start to pick up new rules.

Setup wizard doesn't appear

Run the setup manually:

npx fulcrum init

What's Next

Now that Fulcrum is installed, head to the Quick Start to ship your first feature in 5 minutes.