# stre4k/aprismaos architecture

> Architecture diagram of the GitHub repository stre4k/aprismaos, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/stre4k/aprismaos
- Repository: https://github.com/stre4k/aprismaos

## Overview

AprismaOS is a work-in-progress 32-bit x86 operating-system kernel, with a small accompanying C library. Its present user-visible path is keyboard input through the command-line buffer and shell parsing/dispatch to commands, which report through the terminal. The graph also shows boot/kernel services, CPU and interrupt support, and libc. Kernel initialization and several shell modules are unsampled, so links based only on their apparent roles are omitted; README plans such as filesystems and networking are not represented as implemented components.

Main entry points: [`src/kernel/core/kernel.c`](https://github.com/stre4k/aprismaos/blob/main/src/kernel/core/kernel.c) (Kernel startup), [`src/kernel/drivers/keyboard.c`](https://github.com/stre4k/aprismaos/blob/main/src/kernel/drivers/keyboard.c) (Keyboard driver), [`src/kernel/shell/shell.c`](https://github.com/stre4k/aprismaos/blob/main/src/kernel/shell/shell.c) (Shell loop), [`src/libc`](https://github.com/stre4k/aprismaos/tree/main/src/libc) (C library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot["Boot and Kernel"]
  node_kernel["Kernel startup<br/>[kernel.c]"]
  node_bootinfo["Boot information<br/>[multiboot.c]"]
  node_panic["Kernel panic<br/>[panic.c]"]
  node_printk["Kernel logging<br/>[printk.c]"]
end

subgraph group_hardware["x86 Hardware"]
  node_cpu["CPU detection<br/>[cpuid.c]"]
  node_cpumode["CPU mode<br/>[cpumode.c]"]
  node_gdt["GDT<br/>[gdt.c]"]
  node_idt["IDT<br/>[idt.c]"]
  node_tss["Task state<br/>[tss.c]"]
  node_isr["Interrupt handlers<br/>[isr.c]"]
  node_pic["PIC<br/>[pic.c]"]
  node_lapic["Local APIC<br/>[lapic.c]"]
  node_timer["Timer services<br/>[timer.c]"]
end

subgraph group_interaction["Input and Shell"]
  node_keyboard["Keyboard driver<br/>[keyboard.c]"]
  node_cmdline["Command line<br/>[cmdline.c]"]
  node_shell["Shell loop<br/>[shell.c]"]
  node_parser["Argument parser<br/>[parser.c]"]
  node_commands["Command dispatch<br/>[commands.c]"]
  node_commandset["Shell commands"]
  node_tty["Text terminal<br/>[tty.c]"]
end

subgraph group_library["C Library"]
  node_libc["C library"]
  node_stdio["Formatted output<br/>[printf.c]"]
  node_putchar["Character output<br/>[putchar.c]"]
  node_libcparts["Utility routines"]
end

node_bootloader(("Multiboot loader"))

node_bootloader -->|"starts"| node_kernel
node_kernel -->|"initializes"| node_bootinfo
node_kernel -->|"initializes"| node_gdt
node_kernel -->|"initializes"| node_idt
node_kernel -->|"initializes"| node_tss
node_kernel -->|"detects CPU"| node_cpu
node_cpu -->|"reports"| node_printk
node_kernel -->|"starts"| node_shell
node_shell -->|"parses input"| node_parser
node_shell -->|"dispatches"| node_commands
node_commands -->|"invokes"| node_commandset
node_keyboard -->|"sends characters"| node_cmdline
node_keyboard -->|"updates display"| node_tty
node_keyboard -->|"acknowledges IRQ"| node_pic
node_keyboard -->|"registers handler"| node_isr
node_isr -->|"dispatches IRQ"| node_pic
node_printk -->|"writes characters"| node_tty
node_stdio -->|"writes characters"| node_putchar
node_libc -->|"provides"| node_stdio
node_libc -->|"provides"| node_libcparts

click node_kernel "https://github.com/stre4k/aprismaos/blob/main/src/kernel/core/kernel.c"
click node_bootinfo "https://github.com/stre4k/aprismaos/blob/main/src/kernel/core/multiboot.c"
click node_panic "https://github.com/stre4k/aprismaos/blob/main/src/kernel/core/panic.c"
click node_printk "https://github.com/stre4k/aprismaos/blob/main/src/kernel/core/printk.c"
click node_cpu "https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/cpu/cpuid.c"
click node_cpumode "https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/cpu/cpumode.c"
click node_gdt "https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/descriptors/gdt.c"
click node_idt "https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/descriptors/idt.c"
click node_tss "https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/descriptors/tss.c"
click node_isr "https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/interrupts/isr.c"
click node_pic "https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/interrupts/pic.c"
click node_lapic "https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/interrupts/lapic.c"
click node_timer "https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/interrupts/timer.c"
click node_keyboard "https://github.com/stre4k/aprismaos/blob/main/src/kernel/drivers/keyboard.c"
click node_cmdline "https://github.com/stre4k/aprismaos/blob/main/src/kernel/shell/cmdline.c"
click node_shell "https://github.com/stre4k/aprismaos/blob/main/src/kernel/shell/shell.c"
click node_parser "https://github.com/stre4k/aprismaos/blob/main/src/kernel/shell/parser.c"
click node_commands "https://github.com/stre4k/aprismaos/blob/main/src/kernel/shell/commands/commands.c"
click node_commandset "https://github.com/stre4k/aprismaos/tree/main/src/kernel/shell/commands"
click node_tty "https://github.com/stre4k/aprismaos/blob/main/src/kernel/drivers/tty.c"
click node_libc "https://github.com/stre4k/aprismaos/tree/main/src/libc"
click node_stdio "https://github.com/stre4k/aprismaos/blob/main/src/libc/stdio/printf.c"
click node_putchar "https://github.com/stre4k/aprismaos/blob/main/src/libc/stdio/putchar.c"
click node_libcparts "https://github.com/stre4k/aprismaos/tree/main/src/libc"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_kernel,node_bootinfo,node_panic,node_printk toneBlue
class node_cpu,node_cpumode,node_gdt,node_idt,node_tss,node_isr,node_pic,node_lapic,node_timer toneAmber
class node_keyboard,node_cmdline,node_shell,node_parser,node_commands,node_commandset,node_tty toneMint
class node_libc,node_stdio,node_putchar,node_libcparts toneRose
class node_bootloader toneIndigo
```

## Components

### Boot and Kernel

- [Kernel startup](https://github.com/stre4k/aprismaos/blob/main/src/kernel/core/kernel.c): `src/kernel/core/kernel.c`
- [Boot information](https://github.com/stre4k/aprismaos/blob/main/src/kernel/core/multiboot.c): `src/kernel/core/multiboot.c`
- [Kernel panic](https://github.com/stre4k/aprismaos/blob/main/src/kernel/core/panic.c): `src/kernel/core/panic.c`
- [Kernel logging](https://github.com/stre4k/aprismaos/blob/main/src/kernel/core/printk.c): `src/kernel/core/printk.c`

### x86 Hardware

- [CPU detection](https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/cpu/cpuid.c): `src/kernel/arch/i386/cpu/cpuid.c`
- [CPU mode](https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/cpu/cpumode.c): `src/kernel/arch/i386/cpu/cpumode.c`
- [GDT](https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/descriptors/gdt.c): `src/kernel/arch/i386/descriptors/gdt.c`
- [IDT](https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/descriptors/idt.c): `src/kernel/arch/i386/descriptors/idt.c`
- [Task state](https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/descriptors/tss.c): `src/kernel/arch/i386/descriptors/tss.c`
- [Interrupt handlers](https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/interrupts/isr.c): `src/kernel/arch/i386/interrupts/isr.c`
- [PIC](https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/interrupts/pic.c): `src/kernel/arch/i386/interrupts/pic.c`
- [Local APIC](https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/interrupts/lapic.c): `src/kernel/arch/i386/interrupts/lapic.c`
- [Timer services](https://github.com/stre4k/aprismaos/blob/main/src/kernel/arch/i386/interrupts/timer.c): `src/kernel/arch/i386/interrupts/timer.c`

### Input and Shell

- [Keyboard driver](https://github.com/stre4k/aprismaos/blob/main/src/kernel/drivers/keyboard.c): `src/kernel/drivers/keyboard.c`
- [Command line](https://github.com/stre4k/aprismaos/blob/main/src/kernel/shell/cmdline.c): `src/kernel/shell/cmdline.c`
- [Shell loop](https://github.com/stre4k/aprismaos/blob/main/src/kernel/shell/shell.c): `src/kernel/shell/shell.c`
- [Argument parser](https://github.com/stre4k/aprismaos/blob/main/src/kernel/shell/parser.c): `src/kernel/shell/parser.c`
- [Command dispatch](https://github.com/stre4k/aprismaos/blob/main/src/kernel/shell/commands/commands.c): `src/kernel/shell/commands/commands.c`
- [Shell commands](https://github.com/stre4k/aprismaos/tree/main/src/kernel/shell/commands): `src/kernel/shell/commands`
- [Text terminal](https://github.com/stre4k/aprismaos/blob/main/src/kernel/drivers/tty.c): `src/kernel/drivers/tty.c`

### C Library

- [C library](https://github.com/stre4k/aprismaos/tree/main/src/libc): `src/libc`
- [Formatted output](https://github.com/stre4k/aprismaos/blob/main/src/libc/stdio/printf.c): `src/libc/stdio/printf.c`
- [Character output](https://github.com/stre4k/aprismaos/blob/main/src/libc/stdio/putchar.c): `src/libc/stdio/putchar.c`
- [Utility routines](https://github.com/stre4k/aprismaos/tree/main/src/libc): `src/libc`

### Other components

- **Multiboot loader**

## Connections

- Multiboot loader → Kernel startup: starts
- Kernel startup → Boot information: initializes
- Kernel startup → GDT: initializes
- Kernel startup → IDT: initializes
- Kernel startup → Task state: initializes
- Kernel startup → CPU detection: detects CPU
- CPU detection → Kernel logging: reports
- Kernel startup → Shell loop: starts
- Shell loop → Argument parser: parses input
- Shell loop → Command dispatch: dispatches
- Command dispatch → Shell commands: invokes
- Keyboard driver → Command line: sends characters
- Keyboard driver → Text terminal: updates display
- Keyboard driver → PIC: acknowledges IRQ
- Keyboard driver → Interrupt handlers: registers handler
- Interrupt handlers → PIC: dispatches IRQ
- Kernel logging → Text terminal: writes characters
- Formatted output → Character output: writes characters
- C library → Formatted output: provides
- C library → Utility routines: provides
