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 User

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

As a Contributor

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, Debugging with VSCode and QEMU, and Coding Guidelines articles to get started.

Documentation

• Installation Guide
• Dev Container Setup
• Kernel Compilation Steps
• Debugging with VSCode and QEMU
• Kernel Project Layout
• Coding Guidelines
• 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