Table of Contents

Installation Guide

Prerequisites

Windows

Download and run the latest installer from the Releases page:

CosmosSetup-<version>-windows.exe

After installation, open a new terminal and verify:

cosmos check

To uninstall, use Add or Remove Programs in Windows Settings.

Linux / macOS

Install the Cosmos CLI and all dependencies:

dotnet tool install -g Cosmos.Tools
cosmos install

This will install all required tools via your package manager (apt, dnf, pacman, or brew), the Cosmos patcher, project templates, and the VS Code extension.

Verify installation:

cosmos check

To uninstall:

cosmos uninstall
dotnet tool uninstall -g Cosmos.Tools

Quick Start

Once installed, create and build your first kernel:

cosmos new MyKernel
cd MyKernel
cosmos build

Or open VS Code and use the Cosmos extension to create, build, and run bare-metal C# kernels directly from the editor.

Edit this page