PhreshOS System

The authoritative runtime and web desktop for PhreshOS Programs.

Documentation · Runtime model · Installation · Source

Role

The System owns Program and Process lifecycle, Endpoint execution, routing, authentication, persistence, permissions, host capabilities, and the web Desktop that represents this state.

The browser is a display, not the authority. Client, Server, Node, and CLI consumers reach one shared domain model whose contracts are defined by Core. See What is PhreshOS? for the complete product model.

Installation

The current System requires Node.js 24.15.0 or newer. Install and operate it through the CLI:

phresh system install
phresh system status
phresh system start
phresh system stop
phresh system enable
phresh system disable

Production state uses ~/.phreshos by default. PHRESHOS_HOME selects another System home. See Installation for the complete host and service workflow.

Development

bun install --frozen-lockfile
bun run verify
bun run dev

Build or package the production release with:

bun run build
bun run pack

verify checks the source contracts and validates the packed System from a clean installation.

check performs static checks, build creates distributable output, and test runs Vitest assertions from tests/. Run build before testing built artifacts. verify runs check, build, and test in order. Operational tooling belongs in scripts/; tests and their fixtures belong in tests/. Verification uses the committed dependency graph without local package substitutions.

Related repositories

• @phreshos/core owns the public contracts implemented by the System.
• @phreshos/client and @phreshos/server adapt Client and Server Endpoint boundaries.
• @phreshos/node connects external Node.js code to a running System.
• @phreshos/cli installs and operates the System and its native service.
• PhreshOS Documentation owns the canonical public explanation of the runtime.

Contributing

See CONTRIBUTING.md for the repository workflow and SECURITY.md for private vulnerability reporting.

License

Licensed under the MIT License. Copyright © 2026 Zohayr SLILEH.