How thepuppetqueen57/neptune-os works
Neptune OS is a C-based simulated operating system, not a real OS. Its documented structure includes a bootloader and kernel; the visible runtime path is kernel startup, configuration loading, then an interactive terminal where users can run the built-in calculator or Neptubot. The calculator tokenizes expressions and evaluates them using stack-based support code. The sampled files do not establish how boot.c enters the kernel, so that connection is omitted; other unsampled implementation details are not inferred.
Main entry points: terminal.c Command Terminal · kernel.c Kernel · calculator.h Calculator · tokenizer.c Expression Tokenizer
Components 18
Startup and Kernel
- Bootloader
src/boot.c - Kernel
src/kernel.c - Kernel Config
config/kernel.json - JSON Parser
lib/cJSON.c - JSON API
lib/cJSON.h
Interactive Terminal
- Command Terminal
src/terminal.c - Terminal Interface
src/terminal.h
Built-in Programs
- Calculator
src/programs/calculator.h - Neptubot
src/programs/neptubot.h
Expression Engine
- Expression Tokenizer
lib/seqft/tokenizer.c - Expression Evaluator
lib/seqft/evaluator.c - Dynamic Stack
lib/seqft/stack.c - Math Utilities
lib/seqft/common.c - Tokenizer API
lib/seqft/tokenizer.h - Evaluator API
lib/seqft/evaluator.h - Stack API
lib/seqft/stack.h - Utility API
lib/seqft/common.h
Other components
- User
Connections 20
- Kernel → Kernel Config: reads settings
src/kernel.c - Kernel → JSON Parser: parses config
src/kernel.c - Kernel → Command Terminal: starts shell
src/kernel.c - Kernel → JSON API: uses API
src/kernel.c - Command Terminal → User: reads commands
src/terminal.c - Command Terminal → Calculator: launches
src/terminal.c - Command Terminal → Neptubot: launches
src/terminal.c - Command Terminal → Terminal Interface: implements
src/terminal.c - Calculator → Expression Tokenizer: tokenizes expressions
src/programs/calculator.h - Calculator → Expression Evaluator: evaluates tokens
src/programs/calculator.h - Calculator → Terminal Interface: reports errors
src/programs/calculator.h - Expression Tokenizer → Dynamic Stack: uses stacks
lib/seqft/tokenizer.c - Expression Tokenizer → Math Utilities: uses utilities
lib/seqft/tokenizer.c - Expression Evaluator → Stack API: uses stack API
- Expression Evaluator → Tokenizer API: consumes tokens
- Expression Evaluator → Utility API: uses types
- Expression Tokenizer → Tokenizer API: implements
lib/seqft/tokenizer.c - Dynamic Stack → Stack API: implements
lib/seqft/stack.c - Math Utilities → Utility API: implements
lib/seqft/common.c - JSON Parser → JSON API: implements
lib/cJSON.c