Simple CLI

A simple, CLI-focused Debian-based particle-os system built on Universal Blue's framework. Simple CLI provides a minimal, immutable Linux distribution optimized for command-line usage and server workloads.

Features

• Immutable Filesystem: Built on OSTree for reliable, atomic updates
• Container-Native: Built as a container image, deployed with bootc
• Minimal Footprint: Focused on essential CLI tools and system utilities
• Modern Boot: Uses bootupd for modern bootloader management
• Debian Base: Built on Debian Trixie for stability and package availability

Quick Start

Building the Image

# Clone the repository
git clone https://github.com/your-username/simple-cli.git
cd simple-cli

# Build the container image
just build

# Test the image
just test

# Generate bootable images
just generate-bootable

Using the System

# Show system information
ujust info

# Check OSTree status
ujust ostree-status

# Update the system
ujust update

# View system services
ujust services

Architecture

Simple CLI follows the particle-os architecture:

1. Container Image: The OS is built as a container image using the Containerfile
2. OSTree Deployment: Container images are converted to OSTree commits
3. Bootable Images: bootc-image-builder creates bootable disk images
4. System Management: bootupd handles bootloader updates and management

Directory Structure

simple-cli/
├── Containerfile          # Main container build definition
├── recipe.yml            # particle-os recipe configuration
├── justfile             # Build automation commands
├── config/              # System configuration files
├── usr/                 # User space configurations
├── etc/                 # System-wide configuration
├── build_files/         # Build-time specifications
└── .github/workflows/   # CI/CD automation

Development

Prerequisites

• Podman or Docker
• Just command runner
• bootc-image-builder (for bootable image generation)

Setup Development Environment

just setup-dev

Available Commands

just --list

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with just test
5. Submit a pull request

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

Acknowledgments

• Built on particle-os framework
• Inspired by Aurora and other particle-os projects
• Uses bootc for container-native boot
• Powered by OSTree for immutable filesystems