Welcome to the Cosmos gen3 wiki!

Check out the Roadmap to see our progress toward the first release 🚀.

How to Use

There are two ways to use gen3 depending on your needs:

As a Developer

If you want to develop or contribute to the project, clone the repository and open it in VS Code. The workspace includes tasks for building and debugging kernels, running tests, and launching QEMU. See the Dev Container Setup, Kernel Compilation Steps, and Debugging with VSCode and QEMU articles to get started.

As a User

If you want to build bare-metal C# kernels without setting up the full toolchain manually, use the Cosmos VS Code Extension. It integrates gen3 into VS Code, providing a streamlined experience for creating, building, and running Cosmos kernels directly from the editor. See the Installation guide to get started.

Documentation

• Installation (Cosmos VS Code Extension)
• Dev Container Setup
• Kernel Compilation Steps
• Debugging with VSCode and QEMU
• Kernel Project Layout
• Plugs
• Testing
• Garbage Collector
• Cosmos.Build.Asm
• Cosmos.Build.GCC
• Cosmos.Build.Patcher
• Cosmos.Build.Ilc

Resources

• Cosmos Gen3: The NativeAOT Era and the End of IL2CPU?
• NativeAOT Developer Workflow
• NativeAOT Limitations

xref link xrefmap.yml