Moona is in early access. These steps are for people who already have access. If you do not yet, join the waitlist and we will let you know when access opens.

Installation

Moona installs as a global npm package.

Requirements

Node 20 or later. Moona checks this automatically during setup and reports if your version is too old.
npm (or any npm-compatible package manager).
An AI coding agent you already use: Claude Code, Cursor, VS Code Copilot, or Codex.

Install

bash

Available once you have early access. Join the waitlist

This installs the moona command-line tool globally. You will use it from inside your project directories.

Verify the installation

Run the health check to confirm Moona is installed and your environment is ready:

bash

Available once you have early access. Join the waitlist

moona doctor runs every onboarding check and prints a [ok] / [warn] / [fail] result for each one, along with the fix for anything that needs attention. It exits non-zero if any check fails.

You can also print the installed version:

bash

Available once you have early access. Join the waitlist

Updating Moona

To update to the latest release, stop the daemon, install the new version, then re-run setup to pick up any new protections:

bash

Available once you have early access. Join the waitlist

Re-running moona setup after an upgrade is safe. It merges into your existing configuration without overwriting anything.

← Previous

Introduction

Setup