README
¶
Lilith, master of daemons
Overview
Go-based CLI for orchestrating, monitoring, and controlling background processes with precision It is built for developers & operators who need reliable, fine‑grained control over concurrent jobs without the noise
Features
Core capabilities
- Process orchestration: Spawn & manage background processes with structured metadata and predictable lifecycle control
- Grouping and workflows: Assign related processes to groups for coordinated start, stop, & teardown
- Signal control: Pause, resume, & terminate processes via standard system signals
- Status and history: Inspect live state, invocation history, exit codes, & runtimes at a glance
- File watching: Trigger scripts or tasks when monitored paths change, with debouncing & clean restarts
Use cases
- Development loops: Run linters, test suites, & rebuilds in parallel with clear visibility & control.
- Automation pipelines: Chain scripts & long‑running tasks with grouping & graceful shutdowns.
- Ops tooling: Keep lightweight daemons in check, audit their status, & enforce consistent process behavior.
Design goals
- Predictable: Clear, composable primitives for starting, grouping, & signaling processes.
- Observable: First‑class status, log, & history so you can see what’s running & why.
- Minimal: No hidden magic; sane defaults with explicit configuration when you need it.
Quickstart
Installation
Language-Specific
| Language | Command |
|---|---|
| Go | go install github.com/DanielRivasMD/Lilith@latest |
Pre-built Binaries
Download from Releases.
Usage
| Command | Description |
|---|---|
invoke |
Start a new daemon |
freeze |
Pause a running daemon |
rekindle |
Resurrect a paused or limbo daemon |
slay |
Stop and clean up daemon processes |
tally |
List all active daemons |
summon |
View log of specific daemon(s) |
help |
Display help for any command |
Example
Configuration
Development
Build from source
git clone https://github.com/DanielRivasMD/Lilith
cd Lilith
Language-Specific Setup
| Language | Dev Dependencies | Hot Reload |
|---|---|---|
| Go | go >= 1.21 |
air (live reload) |
License
Copyright (c) 2025
See the LICENSE file for license details.
Documentation
¶
Overview ¶
Copyright © 2025 Daniel Rivas <danielrivasmd@gmail.com>
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
Source Files
Directories