Skip to content

Installation

Install Mavric DevEnv skills for Claude Code.

Run this in your project directory:

curl -fsSL https://raw.githubusercontent.com/mavric/devenv/main/install.sh | bash

That's it! The installer will add:

  • .claude/ - AI skills and commands
  • .devenv/ - Development standards and references

Then open Claude Code and say: "I want to build a SaaS for [your idea]"

Full Installation Guide

The sections below cover detailed setup including prerequisites.

System Requirements

Requirement Minimum Recommended
Claude Code Latest Latest
Node.js 18.0.0 20.x LTS
npm 9.0.0 10.x
PostgreSQL 13.0 16.x
Memory 4GB 8GB+
Disk 2GB 10GB+

Claude Code is Required

Mavric AI Toolchain runs entirely through Claude Code, Anthropic's AI-powered development CLI. All toolchain commands, skills, and workflows are executed within Claude Code sessions.

Step 1: Install Claude Code

Claude Code is the foundation of the Mavric AI Toolchain. Install it globally:

npm install -g @anthropic-ai/claude-code

Then authenticate with your Anthropic account:

claude login

Verify installation:

claude --version

Step 2: Install System Prerequisites

# Install Homebrew if not present
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js and PostgreSQL
brew install node postgresql

# Start PostgreSQL
brew services start postgresql

# Update package list
sudo apt-get update

# Install Node.js (via NodeSource)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install PostgreSQL
sudo apt-get install -y postgresql postgresql-client

# Start PostgreSQL
sudo systemctl start postgresql
sudo systemctl enable postgresql

# In WSL2 Ubuntu terminal
sudo apt-get update

# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Install PostgreSQL
sudo apt-get install -y postgresql postgresql-client

# Start PostgreSQL
sudo service postgresql start

Step 3: Create Your Project

Create a new folder for your project and install the Mavric toolchain:

# Create your project folder
mkdir my-saas-project
cd my-saas-project

# Install the toolchain
curl -fsSL https://raw.githubusercontent.com/mavric/devenv/main/install.sh | bash

# Initialize your own git repo
git init
git add .
git commit -m "Initial commit: Mavric toolchain setup"

Your Project, Your Repo

The installer copies toolchain files into your project. You get a clean starting point for your own repository.

Step 4: Verify Installation

# Check all prerequisites
claude --version   # Claude Code installed
node --version     # v18.x.x or higher
npm --version      # 9.x.x or higher
psql --version     # 13.x or higher
pg_isready         # Should show "accepting connections"

Step 5: Start Using the Toolchain

Launch Claude Code in the toolchain directory:

claude

Claude Code will automatically detect the .claude/ configuration and load all available skills and commands.

Test the Installation

In Claude Code, try:

What skills do you have available?

You should see skills like:

  • saas-project-orchestrator
  • discovery-interviewer
  • backend-bootstrapper
  • schema-architect
  • test-generator

Directory Structure

After installation, your project will have:

my-saas-project/
├── .claude/                 # Claude Code configuration
│   ├── commands/            # Slash commands (/start-project)
│   ├── skills/              # AI skill modules
│   └── templates/           # Document templates
├── .devenv/                 # Development environment
│   ├── setup/
│   │   ├── scripts/         # Setup automation
│   │   └── templates/       # .apsorc schema templates
│   └── docs/                # Reference documentation
└── [your project files]     # Generated as you build

Adding to an Existing Project

To add Mavric AI Toolchain to an existing project:

cd /path/to/your/project

# Install toolchain into your project
curl -fsSL https://raw.githubusercontent.com/mavric/devenv/main/install.sh | bash

Then launch Claude Code in your project:

claude

Contributing to the Toolchain

If you want to contribute to Mavric AI Toolchain:

# Clone with full history
git clone https://github.com/mavric/devenv.git
cd devenv

# Install documentation dependencies (for local preview)
pip install -r requirements-docs.txt

# Preview documentation locally
mkdocs serve
# Opens at http://127.0.0.1:8000

Updating

To update to the latest toolchain version, re-run the installer:

# From your project directory
cd my-saas-project

# Re-run the installer
curl -fsSL https://raw.githubusercontent.com/mavric/devenv/main/install.sh | bash

What Gets Updated

Only the toolchain configuration (.claude/ and .devenv/) is updated. Your project code, schemas, and customizations remain untouched.

Uninstalling

To remove Mavric AI Toolchain:

# Remove the devenv directory
rm -rf devenv

# Projects you created remain intact
# Only the toolchain configuration is removed

To uninstall Claude Code:

npm uninstall -g @anthropic-ai/claude-code

Next Steps