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. If the command is not found, make sure your npm global bin directory is on your PATH.

Version requirement: RunLogos 1.0.3 requires OpenLogos CLI 0.15.16 or later. If yours is older, upgrade with npm install -g @miniidealab/openlogos@latest.

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? Don't use openlogos init for an existing codebase — use openlogos adopt from the repo root instead. After adopting, you can start a change proposal right away: when a change touches a spec document that doesn't exist yet, the agent reverse-engineers it from the current code and adds it to the proposal.

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 →

Updating RunLogos

Since RunLogos 1.0.3, new versions are distributed only through the official download page. Open Settings, click Check for Updates, and when a new version is available click Download from Website — or go to runlogos.cn/download directly. The app no longer downloads or installs update packages by itself.