Installation

RunLogos depends on the OpenLogos CLI (openlogos) to function. The CLI powers core features including project initialization, openlogos verify, change proposals, and the AI Skills harness. Install the CLI first — RunLogos will not work without it.

Step 1 — Install the OpenLogos CLI

Prerequisites

The OpenLogos CLI requires Node.js 18 or later. Check your version:

node --version

If you don't have Node.js installed, download it from nodejs.org (LTS version recommended).

Install

npm install -g @miniidealab/openlogos

Verify

openlogos --version

You should see a version number like 0.7.2. If the command is not found, make sure your npm global bin directory is on your PATH.

macOS / Linux tip: If openlogos is not found after install, run npm config get prefix to find the global bin path, then add <prefix>/bin to your shell's PATH in ~/.zshrc or ~/.bashrc.

Windows tip: npm global packages are usually at %APPDATA%\npm. Make sure that directory is in your system PATH.

Step 2 — Install RunLogos

RunLogos is a native desktop app for macOS and Windows. No account required to install — you only need a license key to unlock Pro features.

System requirements

Download

Go to the download section on the homepage and choose your platform.

• macOS — .dmg installer
• Windows — .exe installer

Install on macOS

1. Open the downloaded .dmg file
2. Drag RunLogos to your Applications folder
3. Open RunLogos from Applications or Spotlight
4. macOS may ask you to confirm opening an app from the internet — click Open

Install on Windows

1. Run the downloaded .exe installer
2. Follow the setup wizard (Next → Next → Install)
3. Launch RunLogos from the Start Menu or desktop shortcut

Step 3 — Initialize your first project

Before opening a project in RunLogos, initialize it with the CLI. Navigate to your project directory and run:

openlogos init

This creates the logos/ directory structure that RunLogos reads:

logos/
  logos.config.json       # project config (locale, modules)
  logos-project.yaml      # resource index RunLogos uses to navigate your project
  resources/              # all Spec Chain artifacts live here
  spec/                   # core methodology specs
  skills/                 # AI Skills for each phase
AGENTS.md                 # AI instruction entry point (auto-detected by Claude Code, OpenCode, etc.)

Existing project? If you're adding OpenLogos to an existing codebase, run openlogos init from the repo root. It won't touch your existing files.

First launch

Open RunLogos and point it at your initialized project folder. RunLogos reads logos/logos-project.yaml to discover all your Spec Chain artifacts and populate the file tree.

On first launch, RunLogos opens in Community mode — free forever, with access to the Markdown editor, Sequence viewer, and Project board.

To unlock the full Spec Chain workflow (OpenAPI editor, SQL Designer, API Orchestration Runner), activate your license key →