JNode — A Java Operating System¶

JNode is an experimental operating system written in Java. It builds its own JVM, kernel, drivers, filesystems, network stack, and GUI, and boots them on bare metal with only a few hundred lines of assembly at the very bottom. It's a platform for exploring OS design, JVM implementation, and system-level Java.

Developed with AI Agents¶

This is a fork of the classic JNode project, maintained as a living experiment in agent-driven development. GitHub Actions and OpenCode agents triage issues, implement fixes, review pull requests, update the wiki, and boot every build in QEMU before it lands. Batching is coordinated through an orchestrator workflow, with agentic skills for QEMU boot testing, JDWP debugging, and filesystem diagnosis.

Quick Links¶

Architecture Overview¶

JNode consists of several major components:

graph TD
    A[Boot Loader] --> B[Kernel]
    B --> C[VmImpl / JVM]
    C --> D[Plugin System]
    D --> E[Core Services]
    E --> F[Drivers]
    E --> G[Filesystems]
    E --> H[Network Stack]
    E --> I[Shell]
    E --> J[GUI / AWT]

See Architecture Overview for details.

Subsystems¶

See Subsystems for details.

Development¶

• Build & Test — Ant-based build, JUnit, regression tests
• Testing — JUnit, regression, boot testing

Reference¶

• Commands — Shell command reference
• Boot Parameters — GRUB/kernel boot options
• Configuration — jnode.properties, plugin lists

See Reference for details.

External Documentation¶

Community¶

• Issues: GitHub Issues
• CI: GitHub Actions

JNode is licensed under the GNU Lesser General Public License v2.1. See LGPL v2.1 for details.