cosmo is a hobby x86 OS. The goal of the project is to implement a very basic OS capable of running a Userland application from the ground up.

The table below shows what modules have been implemented to date. As the project progresses, additional modules will be added.

Development has leaned heavily on the "The litte book about os development" as well as the the OSDev forums as references. Plenty of the source files and commit messages link back to reference material.

cosmo was developed on a Linux PC using Bochs for x86 emulation. The cross compiler, emulator, and additional packages needed to build and run cosmo are all provided within a docker container. To run cosmo in a container you will need:

• Docker
• A Linux Host with an X11 Window System installed (Xming on Windows is also an option though it has not been tested)

All the scripts referenced in this section can be found under the project's scripts directory. When running a script, make sure your current working directory is the cosmo/scripts directory.

To launch the container:

dev.sh

Once the container is created, you will be dropped into a terminal that contains the project files as hosted on the host PC. From here, you can build and run the OS in the Bochs emulator:

To build cosmo:

build.sh

To run the emulator:

run.sh

If the above two commands succeed, you should see a Bochs window like the one shown below.

Project docs can be viewed in HTML. To build the project documentation, pass the -d flag to the scripts/build.sh script:

build.sh -d

After running the above command, cosmo docs will be installed to the project root directory under docs/cosmo_docs.