zlorb 🛠️

A lightweight, systemd-managed continuous integration tool for Git-based projects. zlorb monitors repositories, detects changes, and triggers builds using Bun, keeping your projects up-to-date effortlessly.

zlorb is a Rust-based system with three components: zlorb-service (the monitoring daemon), zlorb-ctl (a CLI for easy management), and zlorb-lib (shared functionality). It watches Git repositories for updates, performs safe fast-forward merges, and runs build commands when changes are detected or build artifacts are missing.

• 🔍 Automatic Change Detection: Tracks repository updates using the git2 library.
• 🔒 Safe Git Operations: Ensures only fast-forward merges are applied.
• 🏗️ Build Triggering: Executes Bun builds when changes occur or dist/ is missing.
• ⚙️ Systemd Integration: Runs reliably with automatic restarts.
• 🖥️ CLI Management: Easily add, remove, or list repositories without service restarts.

Clone the repository:

git clone <repository-url>

Build and install:

just build
sudo systemctl enable zlorb
sudo systemctl start zlorb

currently being refactored

~/.config/zlorb/repositories.toml

[[repository]]
name = "SomeRepo"
path = "/root/SomeRepo"
remote = "origin"
branch = "master"
build_command = "bun"

Manage repositories with zlorb-ctl commands:

# Add a repository
zlorb-ctl add

# List all configured repositories
zlorb-ctl list

# Remove a repository
zlorb-ctl remove my-repo

The justfile handles building and installing binaries to /usr/local/bin/ and the systemd unit file to /usr/lib/systemd/system/. The service runs in the foreground with automatic recovery on failure, ensuring reliable operation.

1. Install zlorb as described above.
2. Configure your repositories using zlorb-ctl add.
3. Start the service with sudo systemctl start zlorb.
4. Monitor build logs via journalctl -u zlorb.

zlorb will automatically keep your repositories updated and built, saving you time and effort.

Want to contribute? Check the System Architecture and Workspace Structure for details. Pull requests and feedback are welcome!

• watch ctl flag that triggers journalctl log watcher
• web output ctl flag that spins up web server
• need to load configs into memory so daemon doesnt need to keep reading file system every iteration