Windowstead is a Godot 4 desktop-resident idle colony sim: an ambient, edge-mounted companion interface where a tiny settlement keeps working while you use the rest of your desktop.
- always-on-top, borderless desktop companion window
- bottom and side dock modes with orientation-specific grid shapes
- in-game startup menu for new/load/settings/exit and dock-style selection
- 2 autonomous workers
- priority-based gather / haul / build task loop
- wood, stone, and food stockpile counters
- 3 buildables with light progression unlocks: hut → workshop → garden
- random ambient events about every 30 seconds
- save/load through an autoload (
user://on desktop,localStorageon web) - starter export presets for Linux, Windows, and macOS
If transparency is not available on a platform/export template, the game falls back to a compact frameless window positioned near a screen edge.
With just:
mise exec -- just --justfile .justfile runThe just targets run a Godot binary from .tools/. Unzip the Linux build listed in godot-toolchain.json into .tools/ before the first run. If a target does not find the binary, set GODOT_BIN to its path.
Directly on macOS:
./.tools/macos/Godot.app/Contents/MacOS/Godot --path .With just:
mise exec -- just --justfile .justfile validateDirectly on macOS:
./.tools/macos/Godot.app/Contents/MacOS/Godot --headless --path . --script res://tests/test_runner.gdexport_presets.cfg includes starter presets for:
- Linux/X11 (
.x86_64) - Windows Desktop (
.exe) - macOS (
.app)
Local export helpers:
mise exec -- just --justfile .justfile build-macos
mise exec -- just --justfile .justfile build-linux
mise exec -- just --justfile .justfile build-windowsTo validate and build for the current platform:
mise exec -- just --justfile .justfile local-buildTooling is pinned with .mise.toml. Run mise trust once in the repo if mise prompts before installing or executing tools. The just targets find the Linux Godot binary in .tools/ by the version pinned in godot-toolchain.json. If that exact file is missing, they use the one Godot binary present in .tools/. If several or none are there, they stop and list what they found. Override the path with GODOT_BIN=/path/to/Godot if needed.
Windowstead is maintained by Miso Space with help from local and AI-assisted contributors. Contributions should preserve the desktop-companion dock UX: bottom strip first, temporary popup menus, and low-attention colony behavior.