ser

A cross-platform CLI tool for managing background services on macOS and Linux systems.

Features

• List services: View all background services with their status
• Show service details: Get detailed information about a specific service
• Start/Stop/Restart services: Control service execution
• Create new services: Interactive service creation with guided prompts
• Cross-platform support: Works on both macOS (launchd) and Linux (systemd)

Installation

cargo binstall kurtbuilds-ser

Usage

# List all services
ser list

# Show details for a specific service
ser show <service-name>

# Start a service
ser start <service-name>

# Stop a service
ser stop <service-name>

# Restart a service
ser restart <service-name>

# Create a new service interactively
ser new

Development

This is a Cargo workspace with two crates:

• ser_lib - Core library with service management functionality
• ser_cli - Command-line interface

This project uses just as a command runner. Available commands:

# Build the project
just build

# Run with arguments
just run list

# Run tests
just test

# Format code
just fmt

# Run linter
just clippy

# Run all CI checks
just ci

# Install locally
just install

Dependencies

• clap - Command line argument parsing
• serde - Serialization/deserialization
• plist - Property list support for macOS
• anyhow - Error handling
• tabled - Table formatting for output
• atty - Terminal detection
• dialoguer - Interactive prompts

Platform Support

• macOS: Uses launchd for service management
• Linux: Uses systemd for service management

License

[Add your license here]