Skip to content
Mahoosuc OS Documentation

Quick Start

Prerequisites

  • Node.js 20+ and npm 10+
  • Docker and Docker Compose
  • Git

Clone and Install

Terminal window
git clone https://github.com/mahoosuc/mahoosuc-operating-system.git
cd devb-system
npm install

Start the Platform

Terminal window
# Start shared infrastructure (postgres, redis, observability)
npm run solo:up


# Check status
npm run solo:status

First Agent Run

Use any /agent-os/ command in Claude Code to begin spec-driven development:

/agent-os/init-spec my-feature

Regenerate Documentation

Terminal window
npm run docs:generate
npm run docs:dev

This regenerates all auto-generated documentation from agents, skills, commands, and product files, then starts the local docs server at http://localhost:4321.