|
Some checks are pending
ci / test (push) Waiting to run
Fixes the %F{ yellow } color bug (Phoebus Gold 214), drops the no-op
site-functions probe, puts fpath before a cached compinit (full audit at
most once per 24h), adds Kitty/application-mode keybindings, replaces
cross-tab SHARE_HISTORY with INC_APPEND_HISTORY, and adds a builtin
vcs_info git branch plus an exit-status prompt arrow. New ZSH_ZPROFILE
bridges /etc/profile (env-update paths, Nix/Flatpak profile.d) into Zsh
login sessions and adds ~/.local/bin to PATH. Seeding stays once-only;
root stays on Bash; /bin/sh untouched.
Verified: cargo fmt --check, clippy --workspace --all-targets -- -D
warnings, cargo test --workspace 757/757, zsh -n on both files plus an
interactive startup smoke test on host zsh 5.9. Installed-session
behavior awaits the disposable VM.
|
||
|---|---|---|
| .forgejo | ||
| .githooks | ||
| .opencode | ||
| docs | ||
| installer | ||
| installer-rs | ||
| scripts | ||
| .gitattributes | ||
| .gitignore | ||
| AGENTS.md | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
Phoebus OS
A modern, stable, Gentoo-based workstation operating system: systemd, Wayland-first, PipeWire, UEFI/GPT, LUKS2, Btrfs with snapshots, a fast Mango + DarkMaterial desktop, Flatpak, and an optional AI administration assistant. AI-first, never AI-dependent.
Stability first: modern architecture + mature implementations + conservative updates + recovery.
Status
A complete encrypted UEFI install has been built and booted in a disposable
VM (ISO detached): GPT + LUKS2 + Btrfs, systemd PID 1, login, networking, and
a verified Wayland desktop stack with Flatpak. See docs/STATUS.md for the
exact implementation/verification matrix and known limitations.
Repository layout
AGENTS.md entry point for AI/human contributors (read first)
docs/ objectives, roadmap, status, architecture, process
installer/live/ Debian-Live installer appliance ISO recipe
installer/tests/vm/ disposable UEFI VM harness (static Rust binary)
installer-rs/ production Rust installer (crates/ workspace)
scripts/ git/dev tooling (hooks, publish, agent-commit)
.githooks/ committed git hooks
The Gentoo LiveGUI ISO is a reference artifact and is not tracked by git.
Build and test
cd installer-rs
cargo fmt --all -- --check
cargo clippy --workspace --all-targets
cargo test --workspace
cargo build --release -p phoebus-installer
Installer quick start (Rust):
phoebus-installer --config FILE --plan # installation plan
phoebus-installer --config FILE --dry-run # no system changes
phoebus-installer --config FILE --install # run the backend
phoebus-installer --config FILE --install --yes \
--luks-passphrase-file /secure/luks.pw \
--user-password-file /secure/user.pw
The normal installation path is entirely deterministic and does not require an LLM. AI is an optional assistant that proposes typed, validated changes which the user approves; it never holds root or a shell.
Documentation
docs/OBJECTIVES.md— vision, philosophy, non-goals.docs/ROADMAP.md— priorities and current status.docs/STATUS.md— implemented / unit-tested / VM-verified.docs/ARCHITECTURE.md— components and safety model.docs/DEVELOPMENT.md— host setup, build, VM testing.docs/CONTRIBUTING.md— standards and definition of done.docs/GIT-WORKFLOW.md— how to commit, push and release.docs/VM-BOOT-VERIFICATION.md— boot evidence.
License
Phoebus OS is licensed under the GNU General Public License, version 2 or
later (GPL-2.0-or-later). See LICENSE.