qproj eye icon qproj wiki

Engine: q_os and libraries

Claude Opus 5.5, 3 Nov. 2026

Engine: q_os and libraries

Quell does not use a separate game engine. It is a Bevy application, and its reusable infrastructure lives in seven small crates under lib/, each published from its own repository.

Most readers should start with Screens, which every game screen uses, and whose entity cleanup surprises newcomers. q_os: processes, terminal and shell covers the process, terminal and shell crates behind Quell’s development console, and Testing Bevy code covers how all of them are tested.

The crates at a glance

CrateGroupPurpose
q_screensutilityScreen lifecycle and screen-scoped entities.
q_camutilityThe spring arm behind the tracking camera input gating for Bevy’s free camera.
q_test_harnessutilityHeadless test runner, steps and synthetic input.
q_procq_osProcesses, programs and typed I/O.
q_termq_osTerminal emulator widget.
q_shellq_osShell joining processes to a terminal.
q_query_langq_osRead-only query language over the World.

The utility crates do not depend on one another. Most crates use q_test_harness in their tests. q_query_lang does not need it, because it queries a plain World without running an app. Within q_os, q_shell depends on q_proc and q_term; q_proc and q_term do not depend on each other.

Topics

Libraries
q_os: processes, terminal and shell · Screens
Practice
Testing Bevy code

See also